From b846444fa1128992c84ea1e11842dd28ce35794a Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:57 +0000 Subject: [PATCH 01/32] chore: update docs/dyn/index.md --- docs/dyn/index.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/dyn/index.md b/docs/dyn/index.md index 9202520aadf..ca60a7b6409 100644 --- a/docs/dyn/index.md +++ b/docs/dyn/index.md @@ -827,17 +827,29 @@ ## merchantapi +* [accounts_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_accounts_v1.html) * [accounts_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_accounts_v1beta.html) +* [conversions_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_conversions_v1.html) * [conversions_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_conversions_v1beta.html) +* [datasources_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_datasources_v1.html) * [datasources_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_datasources_v1beta.html) +* [inventories_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_inventories_v1.html) * [inventories_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_inventories_v1beta.html) +* [issueresolution_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_issueresolution_v1.html) * [issueresolution_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_issueresolution_v1beta.html) +* [lfp_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_lfp_v1.html) * [lfp_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_lfp_v1beta.html) +* [notifications_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_notifications_v1.html) * [notifications_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_notifications_v1beta.html) +* [ordertracking_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_ordertracking_v1.html) * [ordertracking_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_ordertracking_v1beta.html) +* [products_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_products_v1.html) * [products_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_products_v1beta.html) +* [promotions_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_promotions_v1.html) * [promotions_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_promotions_v1beta.html) +* [quota_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_quota_v1.html) * [quota_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_quota_v1beta.html) +* [reports_v1](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_reports_v1.html) * [reports_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_reports_v1beta.html) * [reviews_v1beta](http://googleapis.github.io/google-api-python-client/docs/dyn/merchantapi_reviews_v1beta.html) From d4f8a4404acd27048ce10f22ddb9947018c6b524 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:57 +0000 Subject: [PATCH 02/32] feat(admin): update the api #### admin:directory_v1 The following keys were added: - schemas.ChromeOsDevice.properties.osVersionCompliance (Total Keys: 2) --- .../admin_directory_v1.chromeosdevices.html | 6 ++++++ .../documents/admin.directory_v1.json | 19 ++++++++++++++++++- 2 files changed, 24 insertions(+), 1 deletion(-) diff --git a/docs/dyn/admin_directory_v1.chromeosdevices.html b/docs/dyn/admin_directory_v1.chromeosdevices.html index ec15a294b6f..98b9e5f6444 100644 --- a/docs/dyn/admin_directory_v1.chromeosdevices.html +++ b/docs/dyn/admin_directory_v1.chromeosdevices.html @@ -267,6 +267,7 @@

Method Details

"updateTime": "A String", # Date and time of the last successful OS update. }, "osVersion": "A String", # The Chrome device's operating system version. + "osVersionCompliance": "A String", # Output only. Compliance status of the OS version. "platformVersion": "A String", # The Chrome device's platform version. "recentUsers": [ # A list of recent device users, in descending order, by last login time. { # A list of recent device users, in descending order, by last login time. @@ -465,6 +466,7 @@

Method Details

"updateTime": "A String", # Date and time of the last successful OS update. }, "osVersion": "A String", # The Chrome device's operating system version. + "osVersionCompliance": "A String", # Output only. Compliance status of the OS version. "platformVersion": "A String", # The Chrome device's platform version. "recentUsers": [ # A list of recent device users, in descending order, by last login time. { # A list of recent device users, in descending order, by last login time. @@ -678,6 +680,7 @@

Method Details

"updateTime": "A String", # Date and time of the last successful OS update. }, "osVersion": "A String", # The Chrome device's operating system version. + "osVersionCompliance": "A String", # Output only. Compliance status of the OS version. "platformVersion": "A String", # The Chrome device's platform version. "recentUsers": [ # A list of recent device users, in descending order, by last login time. { # A list of recent device users, in descending order, by last login time. @@ -850,6 +853,7 @@

Method Details

"updateTime": "A String", # Date and time of the last successful OS update. }, "osVersion": "A String", # The Chrome device's operating system version. + "osVersionCompliance": "A String", # Output only. Compliance status of the OS version. "platformVersion": "A String", # The Chrome device's platform version. "recentUsers": [ # A list of recent device users, in descending order, by last login time. { # A list of recent device users, in descending order, by last login time. @@ -1021,6 +1025,7 @@

Method Details

"updateTime": "A String", # Date and time of the last successful OS update. }, "osVersion": "A String", # The Chrome device's operating system version. + "osVersionCompliance": "A String", # Output only. Compliance status of the OS version. "platformVersion": "A String", # The Chrome device's platform version. "recentUsers": [ # A list of recent device users, in descending order, by last login time. { # A list of recent device users, in descending order, by last login time. @@ -1193,6 +1198,7 @@

Method Details

"updateTime": "A String", # Date and time of the last successful OS update. }, "osVersion": "A String", # The Chrome device's operating system version. + "osVersionCompliance": "A String", # Output only. Compliance status of the OS version. "platformVersion": "A String", # The Chrome device's platform version. "recentUsers": [ # A list of recent device users, in descending order, by last login time. { # A list of recent device users, in descending order, by last login time. diff --git a/googleapiclient/discovery_cache/documents/admin.directory_v1.json b/googleapiclient/discovery_cache/documents/admin.directory_v1.json index e6b0dc06b8b..4338efab776 100644 --- a/googleapiclient/discovery_cache/documents/admin.directory_v1.json +++ b/googleapiclient/discovery_cache/documents/admin.directory_v1.json @@ -4671,7 +4671,7 @@ } } }, -"revision": "20250707", +"revision": "20250804", "rootUrl": "https://admin.googleapis.com/", "schemas": { "Alias": { @@ -5840,6 +5840,23 @@ false "description": "The Chrome device's operating system version.", "type": "string" }, +"osVersionCompliance": { +"description": "Output only. Compliance status of the OS version.", +"enum": [ +"complianceUnspecified", +"compliant", +"pending", +"notCompliant" +], +"enumDescriptions": [ +"Compliance status unspecified.", +"Compliance status compliant.", +"Compliance status pending.", +"Compliance status not compliant." +], +"readOnly": true, +"type": "string" +}, "platformVersion": { "description": "The Chrome device's platform version.", "type": "string" From a48a595c231bdbe183ecec01fa63419526597a97 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:57 +0000 Subject: [PATCH 03/32] feat(aiplatform): update the api #### aiplatform:v1 The following keys were added: - schemas.GoogleCloudAiplatformV1DeployRequestEndpointConfig.properties.dedicatedEndpointDisabled.type (Total Keys: 1) - schemas.GoogleCloudAiplatformV1DeployRequestEndpointConfig.properties.dedicatedEndpointEnabled.deprecated (Total Keys: 1) - schemas.GoogleCloudAiplatformV1DeployRequestEndpointConfig.properties.endpointUserId.type (Total Keys: 1) - schemas.GoogleCloudAiplatformV1GenerateContentRequest.properties.modelArmorConfig.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1GroundingChunkRetrievedContext.properties.documentName (Total Keys: 2) - schemas.GoogleCloudAiplatformV1ModelArmorConfig (Total Keys: 4) - schemas.GoogleCloudAiplatformV1ReasoningEngineSpecDeploymentSpec.properties.containerConcurrency (Total Keys: 2) - schemas.GoogleCloudAiplatformV1ReasoningEngineSpecDeploymentSpec.properties.maxInstances (Total Keys: 2) - schemas.GoogleCloudAiplatformV1ReasoningEngineSpecDeploymentSpec.properties.minInstances (Total Keys: 2) - schemas.GoogleCloudAiplatformV1ReasoningEngineSpecDeploymentSpec.properties.pscInterfaceConfig.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1ReasoningEngineSpecDeploymentSpec.properties.resourceLimits (Total Keys: 2) #### aiplatform:v1beta1 The following keys were added: - resources.projects.resources.locations.methods.recommendSpec (Total Keys: 12) - schemas.GoogleCloudAiplatformV1beta1DatasetStats.properties.droppedExampleIndices (Total Keys: 4) - schemas.GoogleCloudAiplatformV1beta1DatasetStats.properties.droppedExampleReasons (Total Keys: 3) - schemas.GoogleCloudAiplatformV1beta1DeployRequestEndpointConfig.properties.dedicatedEndpointDisabled.type (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1DeployRequestEndpointConfig.properties.dedicatedEndpointEnabled.deprecated (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1DeployRequestEndpointConfig.properties.endpointUserId.type (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1EvaluateDatasetRun (Total Keys: 8) - schemas.GoogleCloudAiplatformV1beta1EvaluationConfig (Total Keys: 6) - schemas.GoogleCloudAiplatformV1beta1GenerateContentRequest.properties.modelArmorConfig.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext.properties.documentName (Total Keys: 2) - schemas.GoogleCloudAiplatformV1beta1Memory.properties.expireTime (Total Keys: 2) - schemas.GoogleCloudAiplatformV1beta1Memory.properties.ttl (Total Keys: 2) - schemas.GoogleCloudAiplatformV1beta1ModelArmorConfig (Total Keys: 4) - schemas.GoogleCloudAiplatformV1beta1PreferenceOptimizationDataStats.properties.droppedExampleIndices (Total Keys: 4) - schemas.GoogleCloudAiplatformV1beta1PreferenceOptimizationDataStats.properties.droppedExampleReasons (Total Keys: 3) - schemas.GoogleCloudAiplatformV1beta1PreferenceOptimizationSpec.properties.evaluationConfig.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpec.properties.containerConcurrency (Total Keys: 2) - schemas.GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpec.properties.maxInstances (Total Keys: 2) - schemas.GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpec.properties.minInstances (Total Keys: 2) - schemas.GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpec.properties.pscInterfaceConfig.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpec.properties.resourceLimits (Total Keys: 2) - schemas.GoogleCloudAiplatformV1beta1RecommendSpecRequest (Total Keys: 5) - schemas.GoogleCloudAiplatformV1beta1RecommendSpecResponse (Total Keys: 23) - schemas.GoogleCloudAiplatformV1beta1SupervisedTuningSpec.properties.evaluationConfig.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1TuningJob.properties.evaluateDatasetRuns (Total Keys: 3) - schemas.GoogleCloudAiplatformV1beta1TuningJob.properties.tuningJobState (Total Keys: 2) --- docs/dyn/aiplatform_v1.endpoints.html | 10 + ...tform_v1.projects.locations.endpoints.html | 10 + .../dyn/aiplatform_v1.projects.locations.html | 4 +- ....projects.locations.publishers.models.html | 10 + ...1.projects.locations.reasoningEngines.html | 64 ++ docs/dyn/aiplatform_v1.publishers.models.html | 10 + docs/dyn/aiplatform_v1.reasoningEngines.html | 64 ++ docs/dyn/aiplatform_v1beta1.endpoints.html | 10 + ..._v1beta1.projects.locations.endpoints.html | 10 + ...aiplatform_v1beta1.projects.locations.html | 327 +++++++++- ....projects.locations.publishers.models.html | 10 + ...v1beta1.projects.locations.ragCorpora.html | 8 +- ...1.projects.locations.reasoningEngines.html | 64 ++ ...s.locations.reasoningEngines.memories.html | 10 + ...ions.reasoningEngines.sessions.events.html | 1 + ...s.locations.reasoningEngines.sessions.html | 1 + ...v1beta1.projects.locations.tuningJobs.html | 590 ++++++++++++++++++ .../aiplatform_v1beta1.publishers.models.html | 10 + .../aiplatform_v1beta1.reasoningEngines.html | 64 ++ ...orm_v1beta1.reasoningEngines.memories.html | 10 + ...eta1.reasoningEngines.sessions.events.html | 1 + ...orm_v1beta1.reasoningEngines.sessions.html | 1 + .../documents/aiplatform.v1.json | 67 +- .../documents/aiplatform.v1beta1.json | 317 +++++++++- 24 files changed, 1662 insertions(+), 11 deletions(-) diff --git a/docs/dyn/aiplatform_v1.endpoints.html b/docs/dyn/aiplatform_v1.endpoints.html index b35f0bc0c2b..db7f6466e49 100644 --- a/docs/dyn/aiplatform_v1.endpoints.html +++ b/docs/dyn/aiplatform_v1.endpoints.html @@ -814,6 +814,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -1209,6 +1213,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. @@ -1574,6 +1579,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -1969,6 +1978,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. diff --git a/docs/dyn/aiplatform_v1.projects.locations.endpoints.html b/docs/dyn/aiplatform_v1.projects.locations.endpoints.html index d436bca0ef8..85e65c73e01 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.endpoints.html +++ b/docs/dyn/aiplatform_v1.projects.locations.endpoints.html @@ -1761,6 +1761,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -2156,6 +2160,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. @@ -3998,6 +4003,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -4393,6 +4402,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. diff --git a/docs/dyn/aiplatform_v1.projects.locations.html b/docs/dyn/aiplatform_v1.projects.locations.html index bfd39232391..70aa7598ba5 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.html @@ -595,8 +595,10 @@

Method Details

}, }, "endpointConfig": { # The endpoint config to use for the deployment. # Optional. The endpoint config to use for the deployment. If not specified, the default endpoint config will be used. - "dedicatedEndpointEnabled": True or False, # Optional. If true, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon. + "dedicatedEndpointDisabled": True or False, # Optional. By default, if dedicated endpoint is enabled, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon. If this field is set to true, the dedicated endpoint will be disabled and the deployed model will be exposed through the shared DNS {region}-aiplatform.googleapis.com. + "dedicatedEndpointEnabled": True or False, # Optional. Deprecated. Use dedicated_endpoint_disabled instead. If true, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon. "endpointDisplayName": "A String", # Optional. The user-specified display name of the endpoint. If not set, a default name will be used. + "endpointUserId": "A String", # Optional. Immutable. The ID to use for endpoint, which will become the final component of the endpoint resource name. If not provided, Vertex AI will generate a value for this ID. If the first character is a letter, this value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The last character must be a letter or number. If the first character is a number, this value may be up to 9 characters, and valid characters are `[0-9]` with no leading zeros. When using HTTP/JSON, this field is populated based on a query string argument, such as `?endpoint_id=12345`. This is the fallback for fields that are not included in either the URI or the body. }, "huggingFaceModelId": "A String", # The Hugging Face model to deploy. Format: Hugging Face model ID like `google/gemma-2-2b-it`. "modelConfig": { # The model config to use for the deployment. # Optional. The model config to use for the deployment. If not specified, the default model config will be used. diff --git a/docs/dyn/aiplatform_v1.projects.locations.publishers.models.html b/docs/dyn/aiplatform_v1.projects.locations.publishers.models.html index e6d4fcb9bbb..07a20020688 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.publishers.models.html +++ b/docs/dyn/aiplatform_v1.projects.locations.publishers.models.html @@ -818,6 +818,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -1213,6 +1217,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. @@ -1806,6 +1811,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -2201,6 +2210,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html index 1b9fe701cef..53fc25a8049 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html @@ -138,12 +138,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. @@ -261,12 +277,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. @@ -326,12 +358,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. @@ -396,12 +444,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. diff --git a/docs/dyn/aiplatform_v1.publishers.models.html b/docs/dyn/aiplatform_v1.publishers.models.html index 5beb45f435d..8cefb6ebf3f 100644 --- a/docs/dyn/aiplatform_v1.publishers.models.html +++ b/docs/dyn/aiplatform_v1.publishers.models.html @@ -812,6 +812,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -1207,6 +1211,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. @@ -2145,6 +2150,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -2540,6 +2549,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. diff --git a/docs/dyn/aiplatform_v1.reasoningEngines.html b/docs/dyn/aiplatform_v1.reasoningEngines.html index 95829579d28..f15b920eeaf 100644 --- a/docs/dyn/aiplatform_v1.reasoningEngines.html +++ b/docs/dyn/aiplatform_v1.reasoningEngines.html @@ -132,12 +132,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. @@ -256,12 +272,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. @@ -321,12 +353,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. @@ -391,12 +439,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. diff --git a/docs/dyn/aiplatform_v1beta1.endpoints.html b/docs/dyn/aiplatform_v1beta1.endpoints.html index e0c60d1a50d..032a2babc0b 100644 --- a/docs/dyn/aiplatform_v1beta1.endpoints.html +++ b/docs/dyn/aiplatform_v1beta1.endpoints.html @@ -835,6 +835,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -1241,6 +1245,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. @@ -1614,6 +1619,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -2020,6 +2029,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html b/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html index 1ce1c7160d3..a78375ef11f 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html @@ -1956,6 +1956,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -2362,6 +2366,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. @@ -4401,6 +4406,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -4807,6 +4816,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.html index d32a8c4a8ae..f62c794953e 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.html @@ -337,6 +337,9 @@

Instance Methods

list_next()

Retrieves the next page of results.

+

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

+

Gets a Model's spec recommendations. This API is called by UI, SDK, and internal.

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

Retrieves relevant contexts for a query.

@@ -679,8 +682,10 @@

Method Details

}, }, "endpointConfig": { # The endpoint config to use for the deployment. # Optional. The endpoint config to use for the deployment. If not specified, the default endpoint config will be used. - "dedicatedEndpointEnabled": True or False, # Optional. If true, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon. + "dedicatedEndpointDisabled": True or False, # Optional. By default, if dedicated endpoint is enabled, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon. If this field is set to true, the dedicated endpoint will be disabled and the deployed model will be exposed through the shared DNS {region}-aiplatform.googleapis.com. + "dedicatedEndpointEnabled": True or False, # Optional. Deprecated. Use dedicated_endpoint_disabled instead. If true, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon. "endpointDisplayName": "A String", # Optional. The user-specified display name of the endpoint. If not set, a default name will be used. + "endpointUserId": "A String", # Optional. Immutable. The ID to use for endpoint, which will become the final component of the endpoint resource name. If not provided, Vertex AI will generate a value for this ID. If the first character is a letter, this value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The last character must be a letter or number. If the first character is a number, this value may be up to 9 characters, and valid characters are `[0-9]` with no leading zeros. When using HTTP/JSON, this field is populated based on a query string argument, such as `?endpoint_id=12345`. This is the fallback for fields that are not included in either the URI or the body. }, "huggingFaceModelId": "A String", # The Hugging Face model to deploy. Format: Hugging Face model ID like `google/gemma-2-2b-it`. "modelConfig": { # The model config to use for the deployment. # Optional. The model config to use for the deployment. If not specified, the default model config will be used. @@ -1881,6 +1886,326 @@

Method Details

+
+ recommendSpec(parent, body=None, x__xgafv=None) + 
Gets a Model's spec recommendations. This API is called by UI, SDK, and internal.
+
+Args:
+  parent: string, Required. The resource name of the Location from which to recommend specs. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for ModelService.RecommendSpec.
+  "checkMachineAvailability": True or False, # Optional. If true, check machine availability for the recommended regions. Only return the machine spec in regions where the machine is available.
+  "checkUserQuota": True or False, # Optional. If true, check user quota for the recommended regions. Returns all the machine spec in regions they are available, and also the user quota state for each machine type in each region.
+  "gcsUri": "A String", # Required. The Google Cloud Storage URI of the custom model, storing weights and config files (which can be used to infer the base model).
+}
+
+  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 ModelService.RecommendSpec.
+  "baseModel": "A String", # Output only. The base model used to finetune the custom model.
+  "recommendations": [ # Output only. Recommendations of deployment options for the given custom weights model.
+    { # Recommendation of one deployment option for the given custom weights model in one region. Contains the machine and container spec, and user accelerator quota state.
+      "region": "A String", # The region for the deployment spec (machine).
+      "spec": { # A machine and model container spec. # Output only. The machine and model container specs.
+        "containerSpec": { # Specification of a container for serving predictions. Some fields in this message correspond to fields in the [Kubernetes Container v1 core specification](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core). # Output only. The model container spec.
+          "args": [ # Immutable. Specifies arguments for the command that runs when the container starts. This overrides the container's [`CMD`](https://docs.docker.com/engine/reference/builder/#cmd). Specify this field as an array of executable and arguments, similar to a Docker `CMD`'s "default parameters" form. If you don't specify this field but do specify the command field, then the command from the `command` field runs without any additional arguments. See the [Kubernetes documentation about how the `command` and `args` fields interact with a container's `ENTRYPOINT` and `CMD`](https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#notes). If you don't specify this field and don't specify the `command` field, then the container's [`ENTRYPOINT`](https://docs.docker.com/engine/reference/builder/#cmd) and `CMD` determine what runs based on their default behavior. See the Docker documentation about [how `CMD` and `ENTRYPOINT` interact](https://docs.docker.com/engine/reference/builder/#understand-how-cmd-and-entrypoint-interact). In this field, you can reference [environment variables set by Vertex AI](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables) and environment variables set in the env field. You cannot reference environment variables set in the Docker image. In order for environment variables to be expanded, reference them by using the following syntax: $( VARIABLE_NAME) Note that this differs from Bash variable expansion, which does not use parentheses. If a variable cannot be resolved, the reference in the input string is used unchanged. To avoid variable expansion, you can escape this syntax with `$$`; for example: $$(VARIABLE_NAME) This field corresponds to the `args` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).
+            "A String",
+          ],
+          "command": [ # Immutable. Specifies the command that runs when the container starts. This overrides the container's [ENTRYPOINT](https://docs.docker.com/engine/reference/builder/#entrypoint). Specify this field as an array of executable and arguments, similar to a Docker `ENTRYPOINT`'s "exec" form, not its "shell" form. If you do not specify this field, then the container's `ENTRYPOINT` runs, in conjunction with the args field or the container's [`CMD`](https://docs.docker.com/engine/reference/builder/#cmd), if either exists. If this field is not specified and the container does not have an `ENTRYPOINT`, then refer to the Docker documentation about [how `CMD` and `ENTRYPOINT` interact](https://docs.docker.com/engine/reference/builder/#understand-how-cmd-and-entrypoint-interact). If you specify this field, then you can also specify the `args` field to provide additional arguments for this command. However, if you specify this field, then the container's `CMD` is ignored. See the [Kubernetes documentation about how the `command` and `args` fields interact with a container's `ENTRYPOINT` and `CMD`](https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#notes). In this field, you can reference [environment variables set by Vertex AI](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables) and environment variables set in the env field. You cannot reference environment variables set in the Docker image. In order for environment variables to be expanded, reference them by using the following syntax: $( VARIABLE_NAME) Note that this differs from Bash variable expansion, which does not use parentheses. If a variable cannot be resolved, the reference in the input string is used unchanged. To avoid variable expansion, you can escape this syntax with `$$`; for example: $$(VARIABLE_NAME) This field corresponds to the `command` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).
+            "A String",
+          ],
+          "deploymentTimeout": "A String", # Immutable. Deployment timeout. Limit for deployment timeout is 2 hours.
+          "env": [ # Immutable. List of environment variables to set in the container. After the container starts running, code running in the container can read these environment variables. Additionally, the command and args fields can reference these variables. Later entries in this list can also reference earlier entries. For example, the following example sets the variable `VAR_2` to have the value `foo bar`: ```json [ { "name": "VAR_1", "value": "foo" }, { "name": "VAR_2", "value": "$(VAR_1) bar" } ] ``` If you switch the order of the variables in the example, then the expansion does not occur. This field corresponds to the `env` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).
+            { # Represents an environment variable present in a Container or Python Module.
+              "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier.
+              "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not.
+            },
+          ],
+          "grpcPorts": [ # Immutable. List of ports to expose from the container. Vertex AI sends gRPC prediction requests that it receives to the first port on this list. Vertex AI also sends liveness and health checks to this port. If you do not specify this field, gRPC requests to the container will be disabled. Vertex AI does not use ports other than the first one listed. This field corresponds to the `ports` field of the Kubernetes Containers v1 core API.
+            { # Represents a network port in a container.
+              "containerPort": 42, # The number of the port to expose on the pod's IP address. Must be a valid port number, between 1 and 65535 inclusive.
+            },
+          ],
+          "healthProbe": { # Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic. # Immutable. Specification for Kubernetes readiness probe.
+            "exec": { # ExecAction specifies a command to execute. # ExecAction probes the health of a container by executing a command.
+              "command": [ # Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside a shell, so traditional shell instructions ('|', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.
+                "A String",
+              ],
+            },
+            "failureThreshold": 42, # Number of consecutive failures before the probe is considered failed. Defaults to 3. Minimum value is 1. Maps to Kubernetes probe argument 'failureThreshold'.
+            "grpc": { # GrpcAction checks the health of a container using a gRPC service. # GrpcAction probes the health of a container by sending a gRPC request.
+              "port": 42, # Port number of the gRPC service. Number must be in the range 1 to 65535.
+              "service": "A String", # Service is the name of the service to place in the gRPC HealthCheckRequest. See https://github.com/grpc/grpc/blob/master/doc/health-checking.md. If this is not specified, the default behavior is defined by gRPC.
+            },
+            "httpGet": { # HttpGetAction describes an action based on HTTP Get requests. # HttpGetAction probes the health of a container by sending an HTTP GET request.
+              "host": "A String", # Host name to connect to, defaults to the model serving container's IP. You probably want to set "Host" in httpHeaders instead.
+              "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
+                { # HttpHeader describes a custom header to be used in HTTP probes
+                  "name": "A String", # The header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header.
+                  "value": "A String", # The header field value
+                },
+              ],
+              "path": "A String", # Path to access on the HTTP server.
+              "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+              "scheme": "A String", # Scheme to use for connecting to the host. Defaults to HTTP. Acceptable values are "HTTP" or "HTTPS".
+            },
+            "initialDelaySeconds": 42, # Number of seconds to wait before starting the probe. Defaults to 0. Minimum value is 0. Maps to Kubernetes probe argument 'initialDelaySeconds'.
+            "periodSeconds": 42, # How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Must be less than timeout_seconds. Maps to Kubernetes probe argument 'periodSeconds'.
+            "successThreshold": 42, # Number of consecutive successes before the probe is considered successful. Defaults to 1. Minimum value is 1. Maps to Kubernetes probe argument 'successThreshold'.
+            "tcpSocket": { # TcpSocketAction probes the health of a container by opening a TCP socket connection. # TcpSocketAction probes the health of a container by opening a TCP socket connection.
+              "host": "A String", # Optional: Host name to connect to, defaults to the model serving container's IP.
+              "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+            },
+            "timeoutSeconds": 42, # Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. Must be greater or equal to period_seconds. Maps to Kubernetes probe argument 'timeoutSeconds'.
+          },
+          "healthRoute": "A String", # Immutable. HTTP path on the container to send health checks to. Vertex AI intermittently sends GET requests to this path on the container's IP address and port to check that the container is healthy. Read more about [health checks](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#health). For example, if you set this field to `/bar`, then Vertex AI intermittently sends a GET request to the `/bar` path on the port of your container specified by the first value of this `ModelContainerSpec`'s ports field. If you don't specify this field, it defaults to the following value when you deploy this Model to an Endpoint: /v1/endpoints/ENDPOINT/deployedModels/ DEPLOYED_MODEL:predict The placeholders in this value are replaced as follows: * ENDPOINT: The last segment (following `endpoints/`)of the Endpoint.name][] field of the Endpoint where this Model has been deployed. (Vertex AI makes this value available to your container code as the [`AIP_ENDPOINT_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).) * DEPLOYED_MODEL: DeployedModel.id of the `DeployedModel`. (Vertex AI makes this value available to your container code as the [`AIP_DEPLOYED_MODEL_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).)
+          "imageUri": "A String", # Required. Immutable. URI of the Docker image to be used as the custom container for serving predictions. This URI must identify an image in Artifact Registry or Container Registry. Learn more about the [container publishing requirements](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#publishing), including permissions requirements for the Vertex AI Service Agent. The container image is ingested upon ModelService.UploadModel, stored internally, and this original path is afterwards not used. To learn about the requirements for the Docker image itself, see [Custom container requirements](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#). You can use the URI to one of Vertex AI's [pre-built container images for prediction](https://cloud.google.com/vertex-ai/docs/predictions/pre-built-containers) in this field.
+          "invokeRoutePrefix": "A String", # Immutable. Invoke route prefix for the custom container. "/*" is the only supported value right now. By setting this field, any non-root route on this model will be accessible with invoke http call eg: "/invoke/foo/bar", however the [PredictionService.Invoke] RPC is not supported yet. Only one of `predict_route` or `invoke_route_prefix` can be set, and we default to using `predict_route` if this field is not set. If this field is set, the Model can only be deployed to dedicated endpoint.
+          "livenessProbe": { # Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic. # Immutable. Specification for Kubernetes liveness probe.
+            "exec": { # ExecAction specifies a command to execute. # ExecAction probes the health of a container by executing a command.
+              "command": [ # Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside a shell, so traditional shell instructions ('|', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.
+                "A String",
+              ],
+            },
+            "failureThreshold": 42, # Number of consecutive failures before the probe is considered failed. Defaults to 3. Minimum value is 1. Maps to Kubernetes probe argument 'failureThreshold'.
+            "grpc": { # GrpcAction checks the health of a container using a gRPC service. # GrpcAction probes the health of a container by sending a gRPC request.
+              "port": 42, # Port number of the gRPC service. Number must be in the range 1 to 65535.
+              "service": "A String", # Service is the name of the service to place in the gRPC HealthCheckRequest. See https://github.com/grpc/grpc/blob/master/doc/health-checking.md. If this is not specified, the default behavior is defined by gRPC.
+            },
+            "httpGet": { # HttpGetAction describes an action based on HTTP Get requests. # HttpGetAction probes the health of a container by sending an HTTP GET request.
+              "host": "A String", # Host name to connect to, defaults to the model serving container's IP. You probably want to set "Host" in httpHeaders instead.
+              "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
+                { # HttpHeader describes a custom header to be used in HTTP probes
+                  "name": "A String", # The header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header.
+                  "value": "A String", # The header field value
+                },
+              ],
+              "path": "A String", # Path to access on the HTTP server.
+              "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+              "scheme": "A String", # Scheme to use for connecting to the host. Defaults to HTTP. Acceptable values are "HTTP" or "HTTPS".
+            },
+            "initialDelaySeconds": 42, # Number of seconds to wait before starting the probe. Defaults to 0. Minimum value is 0. Maps to Kubernetes probe argument 'initialDelaySeconds'.
+            "periodSeconds": 42, # How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Must be less than timeout_seconds. Maps to Kubernetes probe argument 'periodSeconds'.
+            "successThreshold": 42, # Number of consecutive successes before the probe is considered successful. Defaults to 1. Minimum value is 1. Maps to Kubernetes probe argument 'successThreshold'.
+            "tcpSocket": { # TcpSocketAction probes the health of a container by opening a TCP socket connection. # TcpSocketAction probes the health of a container by opening a TCP socket connection.
+              "host": "A String", # Optional: Host name to connect to, defaults to the model serving container's IP.
+              "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+            },
+            "timeoutSeconds": 42, # Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. Must be greater or equal to period_seconds. Maps to Kubernetes probe argument 'timeoutSeconds'.
+          },
+          "ports": [ # Immutable. List of ports to expose from the container. Vertex AI sends any prediction requests that it receives to the first port on this list. Vertex AI also sends [liveness and health checks](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#liveness) to this port. If you do not specify this field, it defaults to following value: ```json [ { "containerPort": 8080 } ] ``` Vertex AI does not use ports other than the first one listed. This field corresponds to the `ports` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).
+            { # Represents a network port in a container.
+              "containerPort": 42, # The number of the port to expose on the pod's IP address. Must be a valid port number, between 1 and 65535 inclusive.
+            },
+          ],
+          "predictRoute": "A String", # Immutable. HTTP path on the container to send prediction requests to. Vertex AI forwards requests sent using projects.locations.endpoints.predict to this path on the container's IP address and port. Vertex AI then returns the container's response in the API response. For example, if you set this field to `/foo`, then when Vertex AI receives a prediction request, it forwards the request body in a POST request to the `/foo` path on the port of your container specified by the first value of this `ModelContainerSpec`'s ports field. If you don't specify this field, it defaults to the following value when you deploy this Model to an Endpoint: /v1/endpoints/ENDPOINT/deployedModels/DEPLOYED_MODEL:predict The placeholders in this value are replaced as follows: * ENDPOINT: The last segment (following `endpoints/`)of the Endpoint.name][] field of the Endpoint where this Model has been deployed. (Vertex AI makes this value available to your container code as the [`AIP_ENDPOINT_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).) * DEPLOYED_MODEL: DeployedModel.id of the `DeployedModel`. (Vertex AI makes this value available to your container code as the [`AIP_DEPLOYED_MODEL_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).)
+          "sharedMemorySizeMb": "A String", # Immutable. The amount of the VM memory to reserve as the shared memory for the model in megabytes.
+          "startupProbe": { # Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic. # Immutable. Specification for Kubernetes startup probe.
+            "exec": { # ExecAction specifies a command to execute. # ExecAction probes the health of a container by executing a command.
+              "command": [ # Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside a shell, so traditional shell instructions ('|', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.
+                "A String",
+              ],
+            },
+            "failureThreshold": 42, # Number of consecutive failures before the probe is considered failed. Defaults to 3. Minimum value is 1. Maps to Kubernetes probe argument 'failureThreshold'.
+            "grpc": { # GrpcAction checks the health of a container using a gRPC service. # GrpcAction probes the health of a container by sending a gRPC request.
+              "port": 42, # Port number of the gRPC service. Number must be in the range 1 to 65535.
+              "service": "A String", # Service is the name of the service to place in the gRPC HealthCheckRequest. See https://github.com/grpc/grpc/blob/master/doc/health-checking.md. If this is not specified, the default behavior is defined by gRPC.
+            },
+            "httpGet": { # HttpGetAction describes an action based on HTTP Get requests. # HttpGetAction probes the health of a container by sending an HTTP GET request.
+              "host": "A String", # Host name to connect to, defaults to the model serving container's IP. You probably want to set "Host" in httpHeaders instead.
+              "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
+                { # HttpHeader describes a custom header to be used in HTTP probes
+                  "name": "A String", # The header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header.
+                  "value": "A String", # The header field value
+                },
+              ],
+              "path": "A String", # Path to access on the HTTP server.
+              "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+              "scheme": "A String", # Scheme to use for connecting to the host. Defaults to HTTP. Acceptable values are "HTTP" or "HTTPS".
+            },
+            "initialDelaySeconds": 42, # Number of seconds to wait before starting the probe. Defaults to 0. Minimum value is 0. Maps to Kubernetes probe argument 'initialDelaySeconds'.
+            "periodSeconds": 42, # How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Must be less than timeout_seconds. Maps to Kubernetes probe argument 'periodSeconds'.
+            "successThreshold": 42, # Number of consecutive successes before the probe is considered successful. Defaults to 1. Minimum value is 1. Maps to Kubernetes probe argument 'successThreshold'.
+            "tcpSocket": { # TcpSocketAction probes the health of a container by opening a TCP socket connection. # TcpSocketAction probes the health of a container by opening a TCP socket connection.
+              "host": "A String", # Optional: Host name to connect to, defaults to the model serving container's IP.
+              "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+            },
+            "timeoutSeconds": 42, # Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. Must be greater or equal to period_seconds. Maps to Kubernetes probe argument 'timeoutSeconds'.
+          },
+        },
+        "machineSpec": { # Specification of a single machine. # Output only. The machine spec.
+          "acceleratorCount": 42, # The number of accelerators to attach to the machine.
+          "acceleratorType": "A String", # Immutable. The type of accelerator(s) that may be attached to the machine as per accelerator_count.
+          "machineType": "A String", # Immutable. The type of the machine. See the [list of machine types supported for prediction](https://cloud.google.com/vertex-ai/docs/predictions/configure-compute#machine-types) See the [list of machine types supported for custom training](https://cloud.google.com/vertex-ai/docs/training/configure-compute#machine-types). For DeployedModel this field is optional, and the default value is `n1-standard-2`. For BatchPredictionJob or as part of WorkerPoolSpec this field is required.
+          "multihostGpuNodeCount": 42, # Optional. Immutable. The number of nodes per replica for multihost GPU deployments.
+          "reservationAffinity": { # A ReservationAffinity can be used to configure a Vertex AI resource (e.g., a DeployedModel) to draw its Compute Engine resources from a Shared Reservation, or exclusively from on-demand capacity. # Optional. Immutable. Configuration controlling how this resource pool consumes reservation.
+            "key": "A String", # Optional. Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, use `compute.googleapis.com/reservation-name` as the key and specify the name of your reservation as its value.
+            "reservationAffinityType": "A String", # Required. Specifies the reservation affinity type.
+            "values": [ # Optional. Corresponds to the label values of a reservation resource. This must be the full resource name of the reservation or reservation block.
+              "A String",
+            ],
+          },
+          "tpuTopology": "A String", # Immutable. The topology of the TPUs. Corresponds to the TPU topologies available from GKE. (Example: tpu_topology: "2x2x1").
+        },
+      },
+      "userQuotaState": "A String", # Output only. The user accelerator quota state.
+    },
+  ],
+  "specs": [ # Output only. The machine and model container specs.
+    { # A machine and model container spec.
+      "containerSpec": { # Specification of a container for serving predictions. Some fields in this message correspond to fields in the [Kubernetes Container v1 core specification](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core). # Output only. The model container spec.
+        "args": [ # Immutable. Specifies arguments for the command that runs when the container starts. This overrides the container's [`CMD`](https://docs.docker.com/engine/reference/builder/#cmd). Specify this field as an array of executable and arguments, similar to a Docker `CMD`'s "default parameters" form. If you don't specify this field but do specify the command field, then the command from the `command` field runs without any additional arguments. See the [Kubernetes documentation about how the `command` and `args` fields interact with a container's `ENTRYPOINT` and `CMD`](https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#notes). If you don't specify this field and don't specify the `command` field, then the container's [`ENTRYPOINT`](https://docs.docker.com/engine/reference/builder/#cmd) and `CMD` determine what runs based on their default behavior. See the Docker documentation about [how `CMD` and `ENTRYPOINT` interact](https://docs.docker.com/engine/reference/builder/#understand-how-cmd-and-entrypoint-interact). In this field, you can reference [environment variables set by Vertex AI](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables) and environment variables set in the env field. You cannot reference environment variables set in the Docker image. In order for environment variables to be expanded, reference them by using the following syntax: $( VARIABLE_NAME) Note that this differs from Bash variable expansion, which does not use parentheses. If a variable cannot be resolved, the reference in the input string is used unchanged. To avoid variable expansion, you can escape this syntax with `$$`; for example: $$(VARIABLE_NAME) This field corresponds to the `args` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).
+          "A String",
+        ],
+        "command": [ # Immutable. Specifies the command that runs when the container starts. This overrides the container's [ENTRYPOINT](https://docs.docker.com/engine/reference/builder/#entrypoint). Specify this field as an array of executable and arguments, similar to a Docker `ENTRYPOINT`'s "exec" form, not its "shell" form. If you do not specify this field, then the container's `ENTRYPOINT` runs, in conjunction with the args field or the container's [`CMD`](https://docs.docker.com/engine/reference/builder/#cmd), if either exists. If this field is not specified and the container does not have an `ENTRYPOINT`, then refer to the Docker documentation about [how `CMD` and `ENTRYPOINT` interact](https://docs.docker.com/engine/reference/builder/#understand-how-cmd-and-entrypoint-interact). If you specify this field, then you can also specify the `args` field to provide additional arguments for this command. However, if you specify this field, then the container's `CMD` is ignored. See the [Kubernetes documentation about how the `command` and `args` fields interact with a container's `ENTRYPOINT` and `CMD`](https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#notes). In this field, you can reference [environment variables set by Vertex AI](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables) and environment variables set in the env field. You cannot reference environment variables set in the Docker image. In order for environment variables to be expanded, reference them by using the following syntax: $( VARIABLE_NAME) Note that this differs from Bash variable expansion, which does not use parentheses. If a variable cannot be resolved, the reference in the input string is used unchanged. To avoid variable expansion, you can escape this syntax with `$$`; for example: $$(VARIABLE_NAME) This field corresponds to the `command` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).
+          "A String",
+        ],
+        "deploymentTimeout": "A String", # Immutable. Deployment timeout. Limit for deployment timeout is 2 hours.
+        "env": [ # Immutable. List of environment variables to set in the container. After the container starts running, code running in the container can read these environment variables. Additionally, the command and args fields can reference these variables. Later entries in this list can also reference earlier entries. For example, the following example sets the variable `VAR_2` to have the value `foo bar`: ```json [ { "name": "VAR_1", "value": "foo" }, { "name": "VAR_2", "value": "$(VAR_1) bar" } ] ``` If you switch the order of the variables in the example, then the expansion does not occur. This field corresponds to the `env` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).
+          { # Represents an environment variable present in a Container or Python Module.
+            "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier.
+            "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not.
+          },
+        ],
+        "grpcPorts": [ # Immutable. List of ports to expose from the container. Vertex AI sends gRPC prediction requests that it receives to the first port on this list. Vertex AI also sends liveness and health checks to this port. If you do not specify this field, gRPC requests to the container will be disabled. Vertex AI does not use ports other than the first one listed. This field corresponds to the `ports` field of the Kubernetes Containers v1 core API.
+          { # Represents a network port in a container.
+            "containerPort": 42, # The number of the port to expose on the pod's IP address. Must be a valid port number, between 1 and 65535 inclusive.
+          },
+        ],
+        "healthProbe": { # Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic. # Immutable. Specification for Kubernetes readiness probe.
+          "exec": { # ExecAction specifies a command to execute. # ExecAction probes the health of a container by executing a command.
+            "command": [ # Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside a shell, so traditional shell instructions ('|', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.
+              "A String",
+            ],
+          },
+          "failureThreshold": 42, # Number of consecutive failures before the probe is considered failed. Defaults to 3. Minimum value is 1. Maps to Kubernetes probe argument 'failureThreshold'.
+          "grpc": { # GrpcAction checks the health of a container using a gRPC service. # GrpcAction probes the health of a container by sending a gRPC request.
+            "port": 42, # Port number of the gRPC service. Number must be in the range 1 to 65535.
+            "service": "A String", # Service is the name of the service to place in the gRPC HealthCheckRequest. See https://github.com/grpc/grpc/blob/master/doc/health-checking.md. If this is not specified, the default behavior is defined by gRPC.
+          },
+          "httpGet": { # HttpGetAction describes an action based on HTTP Get requests. # HttpGetAction probes the health of a container by sending an HTTP GET request.
+            "host": "A String", # Host name to connect to, defaults to the model serving container's IP. You probably want to set "Host" in httpHeaders instead.
+            "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
+              { # HttpHeader describes a custom header to be used in HTTP probes
+                "name": "A String", # The header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header.
+                "value": "A String", # The header field value
+              },
+            ],
+            "path": "A String", # Path to access on the HTTP server.
+            "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+            "scheme": "A String", # Scheme to use for connecting to the host. Defaults to HTTP. Acceptable values are "HTTP" or "HTTPS".
+          },
+          "initialDelaySeconds": 42, # Number of seconds to wait before starting the probe. Defaults to 0. Minimum value is 0. Maps to Kubernetes probe argument 'initialDelaySeconds'.
+          "periodSeconds": 42, # How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Must be less than timeout_seconds. Maps to Kubernetes probe argument 'periodSeconds'.
+          "successThreshold": 42, # Number of consecutive successes before the probe is considered successful. Defaults to 1. Minimum value is 1. Maps to Kubernetes probe argument 'successThreshold'.
+          "tcpSocket": { # TcpSocketAction probes the health of a container by opening a TCP socket connection. # TcpSocketAction probes the health of a container by opening a TCP socket connection.
+            "host": "A String", # Optional: Host name to connect to, defaults to the model serving container's IP.
+            "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+          },
+          "timeoutSeconds": 42, # Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. Must be greater or equal to period_seconds. Maps to Kubernetes probe argument 'timeoutSeconds'.
+        },
+        "healthRoute": "A String", # Immutable. HTTP path on the container to send health checks to. Vertex AI intermittently sends GET requests to this path on the container's IP address and port to check that the container is healthy. Read more about [health checks](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#health). For example, if you set this field to `/bar`, then Vertex AI intermittently sends a GET request to the `/bar` path on the port of your container specified by the first value of this `ModelContainerSpec`'s ports field. If you don't specify this field, it defaults to the following value when you deploy this Model to an Endpoint: /v1/endpoints/ENDPOINT/deployedModels/ DEPLOYED_MODEL:predict The placeholders in this value are replaced as follows: * ENDPOINT: The last segment (following `endpoints/`)of the Endpoint.name][] field of the Endpoint where this Model has been deployed. (Vertex AI makes this value available to your container code as the [`AIP_ENDPOINT_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).) * DEPLOYED_MODEL: DeployedModel.id of the `DeployedModel`. (Vertex AI makes this value available to your container code as the [`AIP_DEPLOYED_MODEL_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).)
+        "imageUri": "A String", # Required. Immutable. URI of the Docker image to be used as the custom container for serving predictions. This URI must identify an image in Artifact Registry or Container Registry. Learn more about the [container publishing requirements](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#publishing), including permissions requirements for the Vertex AI Service Agent. The container image is ingested upon ModelService.UploadModel, stored internally, and this original path is afterwards not used. To learn about the requirements for the Docker image itself, see [Custom container requirements](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#). You can use the URI to one of Vertex AI's [pre-built container images for prediction](https://cloud.google.com/vertex-ai/docs/predictions/pre-built-containers) in this field.
+        "invokeRoutePrefix": "A String", # Immutable. Invoke route prefix for the custom container. "/*" is the only supported value right now. By setting this field, any non-root route on this model will be accessible with invoke http call eg: "/invoke/foo/bar", however the [PredictionService.Invoke] RPC is not supported yet. Only one of `predict_route` or `invoke_route_prefix` can be set, and we default to using `predict_route` if this field is not set. If this field is set, the Model can only be deployed to dedicated endpoint.
+        "livenessProbe": { # Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic. # Immutable. Specification for Kubernetes liveness probe.
+          "exec": { # ExecAction specifies a command to execute. # ExecAction probes the health of a container by executing a command.
+            "command": [ # Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside a shell, so traditional shell instructions ('|', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.
+              "A String",
+            ],
+          },
+          "failureThreshold": 42, # Number of consecutive failures before the probe is considered failed. Defaults to 3. Minimum value is 1. Maps to Kubernetes probe argument 'failureThreshold'.
+          "grpc": { # GrpcAction checks the health of a container using a gRPC service. # GrpcAction probes the health of a container by sending a gRPC request.
+            "port": 42, # Port number of the gRPC service. Number must be in the range 1 to 65535.
+            "service": "A String", # Service is the name of the service to place in the gRPC HealthCheckRequest. See https://github.com/grpc/grpc/blob/master/doc/health-checking.md. If this is not specified, the default behavior is defined by gRPC.
+          },
+          "httpGet": { # HttpGetAction describes an action based on HTTP Get requests. # HttpGetAction probes the health of a container by sending an HTTP GET request.
+            "host": "A String", # Host name to connect to, defaults to the model serving container's IP. You probably want to set "Host" in httpHeaders instead.
+            "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
+              { # HttpHeader describes a custom header to be used in HTTP probes
+                "name": "A String", # The header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header.
+                "value": "A String", # The header field value
+              },
+            ],
+            "path": "A String", # Path to access on the HTTP server.
+            "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+            "scheme": "A String", # Scheme to use for connecting to the host. Defaults to HTTP. Acceptable values are "HTTP" or "HTTPS".
+          },
+          "initialDelaySeconds": 42, # Number of seconds to wait before starting the probe. Defaults to 0. Minimum value is 0. Maps to Kubernetes probe argument 'initialDelaySeconds'.
+          "periodSeconds": 42, # How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Must be less than timeout_seconds. Maps to Kubernetes probe argument 'periodSeconds'.
+          "successThreshold": 42, # Number of consecutive successes before the probe is considered successful. Defaults to 1. Minimum value is 1. Maps to Kubernetes probe argument 'successThreshold'.
+          "tcpSocket": { # TcpSocketAction probes the health of a container by opening a TCP socket connection. # TcpSocketAction probes the health of a container by opening a TCP socket connection.
+            "host": "A String", # Optional: Host name to connect to, defaults to the model serving container's IP.
+            "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+          },
+          "timeoutSeconds": 42, # Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. Must be greater or equal to period_seconds. Maps to Kubernetes probe argument 'timeoutSeconds'.
+        },
+        "ports": [ # Immutable. List of ports to expose from the container. Vertex AI sends any prediction requests that it receives to the first port on this list. Vertex AI also sends [liveness and health checks](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#liveness) to this port. If you do not specify this field, it defaults to following value: ```json [ { "containerPort": 8080 } ] ``` Vertex AI does not use ports other than the first one listed. This field corresponds to the `ports` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).
+          { # Represents a network port in a container.
+            "containerPort": 42, # The number of the port to expose on the pod's IP address. Must be a valid port number, between 1 and 65535 inclusive.
+          },
+        ],
+        "predictRoute": "A String", # Immutable. HTTP path on the container to send prediction requests to. Vertex AI forwards requests sent using projects.locations.endpoints.predict to this path on the container's IP address and port. Vertex AI then returns the container's response in the API response. For example, if you set this field to `/foo`, then when Vertex AI receives a prediction request, it forwards the request body in a POST request to the `/foo` path on the port of your container specified by the first value of this `ModelContainerSpec`'s ports field. If you don't specify this field, it defaults to the following value when you deploy this Model to an Endpoint: /v1/endpoints/ENDPOINT/deployedModels/DEPLOYED_MODEL:predict The placeholders in this value are replaced as follows: * ENDPOINT: The last segment (following `endpoints/`)of the Endpoint.name][] field of the Endpoint where this Model has been deployed. (Vertex AI makes this value available to your container code as the [`AIP_ENDPOINT_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).) * DEPLOYED_MODEL: DeployedModel.id of the `DeployedModel`. (Vertex AI makes this value available to your container code as the [`AIP_DEPLOYED_MODEL_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).)
+        "sharedMemorySizeMb": "A String", # Immutable. The amount of the VM memory to reserve as the shared memory for the model in megabytes.
+        "startupProbe": { # Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic. # Immutable. Specification for Kubernetes startup probe.
+          "exec": { # ExecAction specifies a command to execute. # ExecAction probes the health of a container by executing a command.
+            "command": [ # Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside a shell, so traditional shell instructions ('|', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.
+              "A String",
+            ],
+          },
+          "failureThreshold": 42, # Number of consecutive failures before the probe is considered failed. Defaults to 3. Minimum value is 1. Maps to Kubernetes probe argument 'failureThreshold'.
+          "grpc": { # GrpcAction checks the health of a container using a gRPC service. # GrpcAction probes the health of a container by sending a gRPC request.
+            "port": 42, # Port number of the gRPC service. Number must be in the range 1 to 65535.
+            "service": "A String", # Service is the name of the service to place in the gRPC HealthCheckRequest. See https://github.com/grpc/grpc/blob/master/doc/health-checking.md. If this is not specified, the default behavior is defined by gRPC.
+          },
+          "httpGet": { # HttpGetAction describes an action based on HTTP Get requests. # HttpGetAction probes the health of a container by sending an HTTP GET request.
+            "host": "A String", # Host name to connect to, defaults to the model serving container's IP. You probably want to set "Host" in httpHeaders instead.
+            "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
+              { # HttpHeader describes a custom header to be used in HTTP probes
+                "name": "A String", # The header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header.
+                "value": "A String", # The header field value
+              },
+            ],
+            "path": "A String", # Path to access on the HTTP server.
+            "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+            "scheme": "A String", # Scheme to use for connecting to the host. Defaults to HTTP. Acceptable values are "HTTP" or "HTTPS".
+          },
+          "initialDelaySeconds": 42, # Number of seconds to wait before starting the probe. Defaults to 0. Minimum value is 0. Maps to Kubernetes probe argument 'initialDelaySeconds'.
+          "periodSeconds": 42, # How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Must be less than timeout_seconds. Maps to Kubernetes probe argument 'periodSeconds'.
+          "successThreshold": 42, # Number of consecutive successes before the probe is considered successful. Defaults to 1. Minimum value is 1. Maps to Kubernetes probe argument 'successThreshold'.
+          "tcpSocket": { # TcpSocketAction probes the health of a container by opening a TCP socket connection. # TcpSocketAction probes the health of a container by opening a TCP socket connection.
+            "host": "A String", # Optional: Host name to connect to, defaults to the model serving container's IP.
+            "port": 42, # Number of the port to access on the container. Number must be in the range 1 to 65535.
+          },
+          "timeoutSeconds": 42, # Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. Must be greater or equal to period_seconds. Maps to Kubernetes probe argument 'timeoutSeconds'.
+        },
+      },
+      "machineSpec": { # Specification of a single machine. # Output only. The machine spec.
+        "acceleratorCount": 42, # The number of accelerators to attach to the machine.
+        "acceleratorType": "A String", # Immutable. The type of accelerator(s) that may be attached to the machine as per accelerator_count.
+        "machineType": "A String", # Immutable. The type of the machine. See the [list of machine types supported for prediction](https://cloud.google.com/vertex-ai/docs/predictions/configure-compute#machine-types) See the [list of machine types supported for custom training](https://cloud.google.com/vertex-ai/docs/training/configure-compute#machine-types). For DeployedModel this field is optional, and the default value is `n1-standard-2`. For BatchPredictionJob or as part of WorkerPoolSpec this field is required.
+        "multihostGpuNodeCount": 42, # Optional. Immutable. The number of nodes per replica for multihost GPU deployments.
+        "reservationAffinity": { # A ReservationAffinity can be used to configure a Vertex AI resource (e.g., a DeployedModel) to draw its Compute Engine resources from a Shared Reservation, or exclusively from on-demand capacity. # Optional. Immutable. Configuration controlling how this resource pool consumes reservation.
+          "key": "A String", # Optional. Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, use `compute.googleapis.com/reservation-name` as the key and specify the name of your reservation as its value.
+          "reservationAffinityType": "A String", # Required. Specifies the reservation affinity type.
+          "values": [ # Optional. Corresponds to the label values of a reservation resource. This must be the full resource name of the reservation or reservation block.
+            "A String",
+          ],
+        },
+        "tpuTopology": "A String", # Immutable. The topology of the TPUs. Corresponds to the TPU topologies available from GKE. (Example: tpu_topology: "2x2x1").
+      },
+    },
+  ],
+}
+
+
retrieveContexts(parent, body=None, x__xgafv=None) 
Retrieves relevant contexts for a query.
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.publishers.models.html b/docs/dyn/aiplatform_v1beta1.projects.locations.publishers.models.html
index a4dc74bc158..08feb511f26 100644
--- a/docs/dyn/aiplatform_v1beta1.projects.locations.publishers.models.html
+++ b/docs/dyn/aiplatform_v1beta1.projects.locations.publishers.models.html
@@ -923,6 +923,10 @@ 
Method Details

   "labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.
     "a_key": "A String",
   },
+  "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied.
+    "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization.
+    "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization.
+  },
   "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.
     { # Safety settings.
       "category": "A String", # Required. Harm category.
@@ -1329,6 +1333,7 @@ 
Method Details

               "uri": "A String", # URI reference of the chunk.
             },
             "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools.
+              "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document.
               "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool.
                 "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document.
                   "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed.
@@ -2017,6 +2022,10 @@ 
Method Details

   "labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.
     "a_key": "A String",
   },
+  "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied.
+    "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization.
+    "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization.
+  },
   "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.
     { # Safety settings.
       "category": "A String", # Required. Harm category.
@@ -2423,6 +2432,7 @@ 
Method Details

               "uri": "A String", # URI reference of the chunk.
             },
             "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools.
+              "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document.
               "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool.
                 "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document.
                   "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed.
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.html b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.html
index 6241a2ae254..a9abc2ebbe5 100644
--- a/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.html
+++ b/docs/dyn/aiplatform_v1beta1.projects.locations.ragCorpora.html
@@ -165,7 +165,7 @@ 
Method Details

       "modelVersionId": "A String", # Output only. Version ID of the model that is deployed on the endpoint. Present only when the endpoint is not a publisher model.
     },
   },
-  "ragFilesCount": 42, # Output only. Number of RagFiles in the RagCorpus.
+  "ragFilesCount": 42, # Output only. Number of RagFiles in the RagCorpus. NOTE: This field is not populated in the response of VertexRagDataService.ListRagCorpora.
   "ragVectorDbConfig": { # Config for the Vector DB to use for RAG. # Optional. Immutable. The Vector DB config of the RagCorpus.
     "apiAuth": { # The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. # Authentication config for the chosen Vector DB.
       "apiKeyConfig": { # The API secret. # The API secret.
@@ -398,7 +398,7 @@ 
Method Details

       "modelVersionId": "A String", # Output only. Version ID of the model that is deployed on the endpoint. Present only when the endpoint is not a publisher model.
     },
   },
-  "ragFilesCount": 42, # Output only. Number of RagFiles in the RagCorpus.
+  "ragFilesCount": 42, # Output only. Number of RagFiles in the RagCorpus. NOTE: This field is not populated in the response of VertexRagDataService.ListRagCorpora.
   "ragVectorDbConfig": { # Config for the Vector DB to use for RAG. # Optional. Immutable. The Vector DB config of the RagCorpus.
     "apiAuth": { # The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. # Authentication config for the chosen Vector DB.
       "apiKeyConfig": { # The API secret. # The API secret.
@@ -572,7 +572,7 @@ 
Method Details

           "modelVersionId": "A String", # Output only. Version ID of the model that is deployed on the endpoint. Present only when the endpoint is not a publisher model.
         },
       },
-      "ragFilesCount": 42, # Output only. Number of RagFiles in the RagCorpus.
+      "ragFilesCount": 42, # Output only. Number of RagFiles in the RagCorpus. NOTE: This field is not populated in the response of VertexRagDataService.ListRagCorpora.
       "ragVectorDbConfig": { # Config for the Vector DB to use for RAG. # Optional. Immutable. The Vector DB config of the RagCorpus.
         "apiAuth": { # The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. # Authentication config for the chosen Vector DB.
           "apiKeyConfig": { # The API secret. # The API secret.
@@ -752,7 +752,7 @@ 
Method Details

       "modelVersionId": "A String", # Output only. Version ID of the model that is deployed on the endpoint. Present only when the endpoint is not a publisher model.
     },
   },
-  "ragFilesCount": 42, # Output only. Number of RagFiles in the RagCorpus.
+  "ragFilesCount": 42, # Output only. Number of RagFiles in the RagCorpus. NOTE: This field is not populated in the response of VertexRagDataService.ListRagCorpora.
   "ragVectorDbConfig": { # Config for the Vector DB to use for RAG. # Optional. Immutable. The Vector DB config of the RagCorpus.
     "apiAuth": { # The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. # Authentication config for the chosen Vector DB.
       "apiKeyConfig": { # The API secret. # The API secret.
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html
index 32211db82e2..01d1b35846f 100644
--- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html
+++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html
@@ -168,12 +168,28 @@ 
Method Details

       },
     ],
     "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment.
+      "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9.
       "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API.
         { # Represents an environment variable present in a Container or Python Module.
           "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier.
           "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not.
         },
       ],
+      "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100.
+      "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1.
+      "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I.
+        "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project.
+          { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS.
+            "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot.
+            "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible.
+            "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project.
+          },
+        ],
+        "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I.
+      },
+      "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits
+        "a_key": "A String",
+      },
       "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent.
         { # Represents an environment variable where the value is a secret in Cloud Secret Manager.
           "name": "A String", # Required. Name of the secret environment variable.
@@ -301,12 +317,28 @@ 
Method Details

       },
     ],
     "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment.
+      "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9.
       "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API.
         { # Represents an environment variable present in a Container or Python Module.
           "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier.
           "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not.
         },
       ],
+      "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100.
+      "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1.
+      "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I.
+        "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project.
+          { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS.
+            "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot.
+            "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible.
+            "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project.
+          },
+        ],
+        "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I.
+      },
+      "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits
+        "a_key": "A String",
+      },
       "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent.
         { # Represents an environment variable where the value is a secret in Cloud Secret Manager.
           "name": "A String", # Required. Name of the secret environment variable.
@@ -376,12 +408,28 @@ 
Method Details

           },
         ],
         "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment.
+          "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9.
           "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API.
             { # Represents an environment variable present in a Container or Python Module.
               "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier.
               "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not.
             },
           ],
+          "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100.
+          "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1.
+          "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I.
+            "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project.
+              { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS.
+                "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot.
+                "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible.
+                "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project.
+              },
+            ],
+            "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I.
+          },
+          "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits
+            "a_key": "A String",
+          },
           "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent.
             { # Represents an environment variable where the value is a secret in Cloud Secret Manager.
               "name": "A String", # Required. Name of the secret environment variable.
@@ -456,12 +504,28 @@ 
Method Details

       },
     ],
     "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment.
+      "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9.
       "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API.
         { # Represents an environment variable present in a Container or Python Module.
           "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier.
           "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not.
         },
       ],
+      "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100.
+      "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1.
+      "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I.
+        "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project.
+          { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS.
+            "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot.
+            "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible.
+            "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project.
+          },
+        ],
+        "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I.
+      },
+      "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits
+        "a_key": "A String",
+      },
       "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent.
         { # Represents an environment variable where the value is a secret in Cloud Secret Manager.
           "name": "A String", # Required. Name of the secret environment variable.
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html
index 54abf0918f7..f69f23d7175 100644
--- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html
+++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html
@@ -125,11 +125,13 @@ 
Method Details

   "createTime": "A String", # Output only. Timestamp when this Memory was created.
   "description": "A String", # Optional. Description of the Memory.
   "displayName": "A String", # Optional. Display name of the Memory.
+  "expireTime": "A String", # Optional. Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input.
   "fact": "A String", # Required. Semantic knowledge extracted from the source content.
   "name": "A String", # Identifier. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`
   "scope": { # Required. Immutable. The scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'.
     "a_key": "A String",
   },
+  "ttl": "A String", # Optional. Input only. The TTL for this resource. The expiration time is computed: now + TTL.
   "updateTime": "A String", # Output only. Timestamp when this Memory was most recently updated.
 }
 
@@ -325,11 +327,13 @@ 
Method Details

   "createTime": "A String", # Output only. Timestamp when this Memory was created.
   "description": "A String", # Optional. Description of the Memory.
   "displayName": "A String", # Optional. Display name of the Memory.
+  "expireTime": "A String", # Optional. Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input.
   "fact": "A String", # Required. Semantic knowledge extracted from the source content.
   "name": "A String", # Identifier. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`
   "scope": { # Required. Immutable. The scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'.
     "a_key": "A String",
   },
+  "ttl": "A String", # Optional. Input only. The TTL for this resource. The expiration time is computed: now + TTL.
   "updateTime": "A String", # Output only. Timestamp when this Memory was most recently updated.
 }
@@ -357,11 +361,13 @@

Method Details

"createTime": "A String", # Output only. Timestamp when this Memory was created. "description": "A String", # Optional. Description of the Memory. "displayName": "A String", # Optional. Display name of the Memory. + "expireTime": "A String", # Optional. Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input. "fact": "A String", # Required. Semantic knowledge extracted from the source content. "name": "A String", # Identifier. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}` "scope": { # Required. Immutable. The scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'. "a_key": "A String", }, + "ttl": "A String", # Optional. Input only. The TTL for this resource. The expiration time is computed: now + TTL. "updateTime": "A String", # Output only. Timestamp when this Memory was most recently updated. }, ], @@ -396,11 +402,13 @@

Method Details

"createTime": "A String", # Output only. Timestamp when this Memory was created. "description": "A String", # Optional. Description of the Memory. "displayName": "A String", # Optional. Display name of the Memory. + "expireTime": "A String", # Optional. Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input. "fact": "A String", # Required. Semantic knowledge extracted from the source content. "name": "A String", # Identifier. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}` "scope": { # Required. Immutable. The scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'. "a_key": "A String", }, + "ttl": "A String", # Optional. Input only. The TTL for this resource. The expiration time is computed: now + TTL. "updateTime": "A String", # Output only. Timestamp when this Memory was most recently updated. } @@ -474,11 +482,13 @@

Method Details

"createTime": "A String", # Output only. Timestamp when this Memory was created. "description": "A String", # Optional. Description of the Memory. "displayName": "A String", # Optional. Display name of the Memory. + "expireTime": "A String", # Optional. Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input. "fact": "A String", # Required. Semantic knowledge extracted from the source content. "name": "A String", # Identifier. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}` "scope": { # Required. Immutable. The scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'. "a_key": "A String", }, + "ttl": "A String", # Optional. Input only. The TTL for this resource. The expiration time is computed: now + TTL. "updateTime": "A String", # Output only. Timestamp when this Memory was most recently updated. }, }, diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.events.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.events.html index d57617e590f..80f48158e06 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.events.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.events.html @@ -207,6 +207,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html index 31a45e96d70..705f0449a1d 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html @@ -216,6 +216,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html index fc4f6d9e297..3a494fd8599 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html @@ -173,6 +173,21 @@

Method Details

], "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. }, + "evaluateDatasetRuns": [ # Output only. Evaluation runs for the Tuning Job. + { # Evaluate Dataset Run Result for Tuning Job. + "checkpointId": "A String", # Output only. The checkpoint id used in the evaluation run. Only populated when evaluating checkpoints. + "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The error of the evaluation run if any. + "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. + }, + "operationName": "A String", # Output only. The operation ID of the evaluation run. Format: `projects/{project}/locations/{location}/operations/{operation_id}`. + }, + ], "experiment": "A String", # Output only. The Experiment associated with this TuningJob. "labels": { # Optional. The labels with user-defined metadata to organize TuningJob and generated resources such as Model and Endpoint. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. "a_key": "A String", @@ -193,6 +208,51 @@

Method Details

"tunedModelName": "A String", # The resource name of the Model. E.g., a model resource name with a specified version id or alias: `projects/{project}/locations/{location}/models/{model}@{version_id}` `projects/{project}/locations/{location}/models/{model}@{alias}` Or, omit the version id to use the default version: `projects/{project}/locations/{location}/models/{model}` }, "preferenceOptimizationSpec": { # Tuning Spec for Preference Optimization. # Tuning Spec for Preference Optimization. + "evaluationConfig": { # Evaluation Config for Tuning Job. # Optional. Evaluation Config for Preference Optimization Job. + "autoraterConfig": { # The configs for autorater. This is applicable to both EvaluateInstances and EvaluateDataset. # Optional. Autorater config for evaluation. + "autoraterModel": "A String", # Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}` + "flipEnabled": True or False, # Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias. + "samplingCount": 42, # Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32. + }, + "metrics": [ # Required. The metrics used for evaluation. + { # The metric used for running evaluations. + "aggregationMetrics": [ # Optional. The aggregation metrics to use. + "A String", + ], + "bleuSpec": { # Spec for bleu score metric - calculates the precision of n-grams in the prediction as compared to reference - returns a score ranging between 0 to 1. # Spec for bleu metric. + "useEffectiveOrder": True or False, # Optional. Whether to use_effective_order to compute bleu score. + }, + "exactMatchSpec": { # Spec for exact match metric - returns 1 if prediction and reference exactly matches, otherwise 0. # Spec for exact match metric. + }, + "pairwiseMetricSpec": { # Spec for pairwise metric. # Spec for pairwise metric. + "baselineResponseFieldName": "A String", # Optional. The field name of the baseline response. + "candidateResponseFieldName": "A String", # Optional. The field name of the candidate response. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. When this config is set, the default output is replaced with the raw output string. If a custom format is chosen, the `pairwise_choice` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pairwise metric. + "systemInstruction": "A String", # Optional. System instructions for pairwise metric. + }, + "pointwiseMetricSpec": { # Spec for pointwise metric. # Spec for pointwise metric. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. By default, metrics return a score and explanation. When this config is set, the default output is replaced with either: - The raw output string. - A parsed output based on a user-defined schema. If a custom format is chosen, the `score` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pointwise metric. + "systemInstruction": "A String", # Optional. System instructions for pointwise metric. + }, + "rougeSpec": { # Spec for rouge score metric - calculates the recall of n-grams in prediction as compared to reference - returns a score ranging between 0 and 1. # Spec for rouge metric. + "rougeType": "A String", # Optional. Supported rouge types are rougen[1-9], rougeL, and rougeLsum. + "splitSummaries": True or False, # Optional. Whether to split summaries while using rougeLsum. + "useStemmer": True or False, # Optional. Whether to use stemmer to compute rouge score. + }, + }, + ], + "outputConfig": { # Config for evaluation output. # Required. Config for evaluation output. + "gcsDestination": { # The Google Cloud Storage location where the output is to be written to. # Cloud storage destination for evaluation output. + "outputUriPrefix": "A String", # Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist. + }, + }, + }, "hyperParameters": { # Hyperparameters for Preference Optimization. # Optional. Hyperparameters for Preference Optimization. "adapterSize": "A String", # Optional. Adapter size for preference optimization. "beta": 3.14, # Optional. Weight for KL Divergence regularization. @@ -208,6 +268,51 @@

Method Details

"startTime": "A String", # Output only. Time when the TuningJob for the first time entered the `JOB_STATE_RUNNING` state. "state": "A String", # Output only. The detailed state of the job. "supervisedTuningSpec": { # Tuning Spec for Supervised Tuning for first party models. # Tuning Spec for Supervised Fine Tuning. + "evaluationConfig": { # Evaluation Config for Tuning Job. # Optional. Evaluation Config for Tuning Job. + "autoraterConfig": { # The configs for autorater. This is applicable to both EvaluateInstances and EvaluateDataset. # Optional. Autorater config for evaluation. + "autoraterModel": "A String", # Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}` + "flipEnabled": True or False, # Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias. + "samplingCount": 42, # Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32. + }, + "metrics": [ # Required. The metrics used for evaluation. + { # The metric used for running evaluations. + "aggregationMetrics": [ # Optional. The aggregation metrics to use. + "A String", + ], + "bleuSpec": { # Spec for bleu score metric - calculates the precision of n-grams in the prediction as compared to reference - returns a score ranging between 0 to 1. # Spec for bleu metric. + "useEffectiveOrder": True or False, # Optional. Whether to use_effective_order to compute bleu score. + }, + "exactMatchSpec": { # Spec for exact match metric - returns 1 if prediction and reference exactly matches, otherwise 0. # Spec for exact match metric. + }, + "pairwiseMetricSpec": { # Spec for pairwise metric. # Spec for pairwise metric. + "baselineResponseFieldName": "A String", # Optional. The field name of the baseline response. + "candidateResponseFieldName": "A String", # Optional. The field name of the candidate response. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. When this config is set, the default output is replaced with the raw output string. If a custom format is chosen, the `pairwise_choice` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pairwise metric. + "systemInstruction": "A String", # Optional. System instructions for pairwise metric. + }, + "pointwiseMetricSpec": { # Spec for pointwise metric. # Spec for pointwise metric. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. By default, metrics return a score and explanation. When this config is set, the default output is replaced with either: - The raw output string. - A parsed output based on a user-defined schema. If a custom format is chosen, the `score` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pointwise metric. + "systemInstruction": "A String", # Optional. System instructions for pointwise metric. + }, + "rougeSpec": { # Spec for rouge score metric - calculates the recall of n-grams in prediction as compared to reference - returns a score ranging between 0 and 1. # Spec for rouge metric. + "rougeType": "A String", # Optional. Supported rouge types are rougen[1-9], rougeL, and rougeLsum. + "splitSummaries": True or False, # Optional. Whether to split summaries while using rougeLsum. + "useStemmer": True or False, # Optional. Whether to use stemmer to compute rouge score. + }, + }, + ], + "outputConfig": { # Config for evaluation output. # Required. Config for evaluation output. + "gcsDestination": { # The Google Cloud Storage location where the output is to be written to. # Cloud storage destination for evaluation output. + "outputUriPrefix": "A String", # Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist. + }, + }, + }, "exportLastCheckpointOnly": True or False, # Optional. If set to true, disable intermediate checkpoints for SFT and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for SFT. Default is false. "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT. "adapterSize": "A String", # Optional. Adapter size for tuning. @@ -236,6 +341,12 @@

Method Details

"tuningDataStats": { # The tuning data statistic values for TuningJob. # Output only. The tuning data statistics associated with this TuningJob. "distillationDataStats": { # Statistics computed for datasets used for distillation. # Output only. Statistics for distillation. "trainingDatasetStats": { # Statistics computed over a tuning dataset. # Output only. Statistics computed for the training dataset. + "droppedExampleIndices": [ # Output only. A partial sample of the indices (starting from 1) of the dropped examples. + "A String", + ], + "droppedExampleReasons": [ # Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped. + "A String", + ], "totalBillableCharacterCount": "A String", # Output only. Number of billable characters in the tuning dataset. "totalTuningCharacterCount": "A String", # Output only. Number of tuning characters in the tuning dataset. "tuningDatasetExampleCount": "A String", # Output only. Number of examples in the tuning dataset. @@ -340,6 +451,12 @@

Method Details

}, }, "preferenceOptimizationDataStats": { # Statistics computed for datasets used for preference optimization. # Output only. Statistics for preference optimization. + "droppedExampleIndices": [ # Output only. A partial sample of the indices (starting from 1) of the dropped examples. + "A String", + ], + "droppedExampleReasons": [ # Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped. + "A String", + ], "scoreVariancePerExampleDistribution": { # Distribution computed over a tuning dataset. # Output only. Dataset distributions for scores variance per example. "buckets": [ # Output only. Defines the histogram bucket. { # Dataset bucket used to create a histogram for the distribution given a population of values. @@ -628,6 +745,7 @@

Method Details

}, }, }, + "tuningJobState": "A String", # Output only. The detail state of the tuning job (while the overall `JobState` is running). "updateTime": "A String", # Output only. Time when the TuningJob was most recently updated. "veoTuningSpec": { # Tuning Spec for Veo Model Tuning. # Tuning Spec for Veo Tuning. "hyperParameters": { # Hyperparameters for Veo. # Optional. Hyperparameters for Veo. @@ -679,6 +797,21 @@

Method Details

], "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. }, + "evaluateDatasetRuns": [ # Output only. Evaluation runs for the Tuning Job. + { # Evaluate Dataset Run Result for Tuning Job. + "checkpointId": "A String", # Output only. The checkpoint id used in the evaluation run. Only populated when evaluating checkpoints. + "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The error of the evaluation run if any. + "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. + }, + "operationName": "A String", # Output only. The operation ID of the evaluation run. Format: `projects/{project}/locations/{location}/operations/{operation_id}`. + }, + ], "experiment": "A String", # Output only. The Experiment associated with this TuningJob. "labels": { # Optional. The labels with user-defined metadata to organize TuningJob and generated resources such as Model and Endpoint. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. "a_key": "A String", @@ -699,6 +832,51 @@

Method Details

"tunedModelName": "A String", # The resource name of the Model. E.g., a model resource name with a specified version id or alias: `projects/{project}/locations/{location}/models/{model}@{version_id}` `projects/{project}/locations/{location}/models/{model}@{alias}` Or, omit the version id to use the default version: `projects/{project}/locations/{location}/models/{model}` }, "preferenceOptimizationSpec": { # Tuning Spec for Preference Optimization. # Tuning Spec for Preference Optimization. + "evaluationConfig": { # Evaluation Config for Tuning Job. # Optional. Evaluation Config for Preference Optimization Job. + "autoraterConfig": { # The configs for autorater. This is applicable to both EvaluateInstances and EvaluateDataset. # Optional. Autorater config for evaluation. + "autoraterModel": "A String", # Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}` + "flipEnabled": True or False, # Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias. + "samplingCount": 42, # Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32. + }, + "metrics": [ # Required. The metrics used for evaluation. + { # The metric used for running evaluations. + "aggregationMetrics": [ # Optional. The aggregation metrics to use. + "A String", + ], + "bleuSpec": { # Spec for bleu score metric - calculates the precision of n-grams in the prediction as compared to reference - returns a score ranging between 0 to 1. # Spec for bleu metric. + "useEffectiveOrder": True or False, # Optional. Whether to use_effective_order to compute bleu score. + }, + "exactMatchSpec": { # Spec for exact match metric - returns 1 if prediction and reference exactly matches, otherwise 0. # Spec for exact match metric. + }, + "pairwiseMetricSpec": { # Spec for pairwise metric. # Spec for pairwise metric. + "baselineResponseFieldName": "A String", # Optional. The field name of the baseline response. + "candidateResponseFieldName": "A String", # Optional. The field name of the candidate response. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. When this config is set, the default output is replaced with the raw output string. If a custom format is chosen, the `pairwise_choice` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pairwise metric. + "systemInstruction": "A String", # Optional. System instructions for pairwise metric. + }, + "pointwiseMetricSpec": { # Spec for pointwise metric. # Spec for pointwise metric. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. By default, metrics return a score and explanation. When this config is set, the default output is replaced with either: - The raw output string. - A parsed output based on a user-defined schema. If a custom format is chosen, the `score` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pointwise metric. + "systemInstruction": "A String", # Optional. System instructions for pointwise metric. + }, + "rougeSpec": { # Spec for rouge score metric - calculates the recall of n-grams in prediction as compared to reference - returns a score ranging between 0 and 1. # Spec for rouge metric. + "rougeType": "A String", # Optional. Supported rouge types are rougen[1-9], rougeL, and rougeLsum. + "splitSummaries": True or False, # Optional. Whether to split summaries while using rougeLsum. + "useStemmer": True or False, # Optional. Whether to use stemmer to compute rouge score. + }, + }, + ], + "outputConfig": { # Config for evaluation output. # Required. Config for evaluation output. + "gcsDestination": { # The Google Cloud Storage location where the output is to be written to. # Cloud storage destination for evaluation output. + "outputUriPrefix": "A String", # Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist. + }, + }, + }, "hyperParameters": { # Hyperparameters for Preference Optimization. # Optional. Hyperparameters for Preference Optimization. "adapterSize": "A String", # Optional. Adapter size for preference optimization. "beta": 3.14, # Optional. Weight for KL Divergence regularization. @@ -714,6 +892,51 @@

Method Details

"startTime": "A String", # Output only. Time when the TuningJob for the first time entered the `JOB_STATE_RUNNING` state. "state": "A String", # Output only. The detailed state of the job. "supervisedTuningSpec": { # Tuning Spec for Supervised Tuning for first party models. # Tuning Spec for Supervised Fine Tuning. + "evaluationConfig": { # Evaluation Config for Tuning Job. # Optional. Evaluation Config for Tuning Job. + "autoraterConfig": { # The configs for autorater. This is applicable to both EvaluateInstances and EvaluateDataset. # Optional. Autorater config for evaluation. + "autoraterModel": "A String", # Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}` + "flipEnabled": True or False, # Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias. + "samplingCount": 42, # Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32. + }, + "metrics": [ # Required. The metrics used for evaluation. + { # The metric used for running evaluations. + "aggregationMetrics": [ # Optional. The aggregation metrics to use. + "A String", + ], + "bleuSpec": { # Spec for bleu score metric - calculates the precision of n-grams in the prediction as compared to reference - returns a score ranging between 0 to 1. # Spec for bleu metric. + "useEffectiveOrder": True or False, # Optional. Whether to use_effective_order to compute bleu score. + }, + "exactMatchSpec": { # Spec for exact match metric - returns 1 if prediction and reference exactly matches, otherwise 0. # Spec for exact match metric. + }, + "pairwiseMetricSpec": { # Spec for pairwise metric. # Spec for pairwise metric. + "baselineResponseFieldName": "A String", # Optional. The field name of the baseline response. + "candidateResponseFieldName": "A String", # Optional. The field name of the candidate response. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. When this config is set, the default output is replaced with the raw output string. If a custom format is chosen, the `pairwise_choice` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pairwise metric. + "systemInstruction": "A String", # Optional. System instructions for pairwise metric. + }, + "pointwiseMetricSpec": { # Spec for pointwise metric. # Spec for pointwise metric. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. By default, metrics return a score and explanation. When this config is set, the default output is replaced with either: - The raw output string. - A parsed output based on a user-defined schema. If a custom format is chosen, the `score` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pointwise metric. + "systemInstruction": "A String", # Optional. System instructions for pointwise metric. + }, + "rougeSpec": { # Spec for rouge score metric - calculates the recall of n-grams in prediction as compared to reference - returns a score ranging between 0 and 1. # Spec for rouge metric. + "rougeType": "A String", # Optional. Supported rouge types are rougen[1-9], rougeL, and rougeLsum. + "splitSummaries": True or False, # Optional. Whether to split summaries while using rougeLsum. + "useStemmer": True or False, # Optional. Whether to use stemmer to compute rouge score. + }, + }, + ], + "outputConfig": { # Config for evaluation output. # Required. Config for evaluation output. + "gcsDestination": { # The Google Cloud Storage location where the output is to be written to. # Cloud storage destination for evaluation output. + "outputUriPrefix": "A String", # Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist. + }, + }, + }, "exportLastCheckpointOnly": True or False, # Optional. If set to true, disable intermediate checkpoints for SFT and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for SFT. Default is false. "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT. "adapterSize": "A String", # Optional. Adapter size for tuning. @@ -742,6 +965,12 @@

Method Details

"tuningDataStats": { # The tuning data statistic values for TuningJob. # Output only. The tuning data statistics associated with this TuningJob. "distillationDataStats": { # Statistics computed for datasets used for distillation. # Output only. Statistics for distillation. "trainingDatasetStats": { # Statistics computed over a tuning dataset. # Output only. Statistics computed for the training dataset. + "droppedExampleIndices": [ # Output only. A partial sample of the indices (starting from 1) of the dropped examples. + "A String", + ], + "droppedExampleReasons": [ # Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped. + "A String", + ], "totalBillableCharacterCount": "A String", # Output only. Number of billable characters in the tuning dataset. "totalTuningCharacterCount": "A String", # Output only. Number of tuning characters in the tuning dataset. "tuningDatasetExampleCount": "A String", # Output only. Number of examples in the tuning dataset. @@ -846,6 +1075,12 @@

Method Details

}, }, "preferenceOptimizationDataStats": { # Statistics computed for datasets used for preference optimization. # Output only. Statistics for preference optimization. + "droppedExampleIndices": [ # Output only. A partial sample of the indices (starting from 1) of the dropped examples. + "A String", + ], + "droppedExampleReasons": [ # Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped. + "A String", + ], "scoreVariancePerExampleDistribution": { # Distribution computed over a tuning dataset. # Output only. Dataset distributions for scores variance per example. "buckets": [ # Output only. Defines the histogram bucket. { # Dataset bucket used to create a histogram for the distribution given a population of values. @@ -1134,6 +1369,7 @@

Method Details

}, }, }, + "tuningJobState": "A String", # Output only. The detail state of the tuning job (while the overall `JobState` is running). "updateTime": "A String", # Output only. Time when the TuningJob was most recently updated. "veoTuningSpec": { # Tuning Spec for Veo Model Tuning. # Tuning Spec for Veo Tuning. "hyperParameters": { # Hyperparameters for Veo. # Optional. Hyperparameters for Veo. @@ -1192,6 +1428,21 @@

Method Details

], "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. }, + "evaluateDatasetRuns": [ # Output only. Evaluation runs for the Tuning Job. + { # Evaluate Dataset Run Result for Tuning Job. + "checkpointId": "A String", # Output only. The checkpoint id used in the evaluation run. Only populated when evaluating checkpoints. + "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The error of the evaluation run if any. + "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. + }, + "operationName": "A String", # Output only. The operation ID of the evaluation run. Format: `projects/{project}/locations/{location}/operations/{operation_id}`. + }, + ], "experiment": "A String", # Output only. The Experiment associated with this TuningJob. "labels": { # Optional. The labels with user-defined metadata to organize TuningJob and generated resources such as Model and Endpoint. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. "a_key": "A String", @@ -1212,6 +1463,51 @@

Method Details

"tunedModelName": "A String", # The resource name of the Model. E.g., a model resource name with a specified version id or alias: `projects/{project}/locations/{location}/models/{model}@{version_id}` `projects/{project}/locations/{location}/models/{model}@{alias}` Or, omit the version id to use the default version: `projects/{project}/locations/{location}/models/{model}` }, "preferenceOptimizationSpec": { # Tuning Spec for Preference Optimization. # Tuning Spec for Preference Optimization. + "evaluationConfig": { # Evaluation Config for Tuning Job. # Optional. Evaluation Config for Preference Optimization Job. + "autoraterConfig": { # The configs for autorater. This is applicable to both EvaluateInstances and EvaluateDataset. # Optional. Autorater config for evaluation. + "autoraterModel": "A String", # Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}` + "flipEnabled": True or False, # Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias. + "samplingCount": 42, # Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32. + }, + "metrics": [ # Required. The metrics used for evaluation. + { # The metric used for running evaluations. + "aggregationMetrics": [ # Optional. The aggregation metrics to use. + "A String", + ], + "bleuSpec": { # Spec for bleu score metric - calculates the precision of n-grams in the prediction as compared to reference - returns a score ranging between 0 to 1. # Spec for bleu metric. + "useEffectiveOrder": True or False, # Optional. Whether to use_effective_order to compute bleu score. + }, + "exactMatchSpec": { # Spec for exact match metric - returns 1 if prediction and reference exactly matches, otherwise 0. # Spec for exact match metric. + }, + "pairwiseMetricSpec": { # Spec for pairwise metric. # Spec for pairwise metric. + "baselineResponseFieldName": "A String", # Optional. The field name of the baseline response. + "candidateResponseFieldName": "A String", # Optional. The field name of the candidate response. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. When this config is set, the default output is replaced with the raw output string. If a custom format is chosen, the `pairwise_choice` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pairwise metric. + "systemInstruction": "A String", # Optional. System instructions for pairwise metric. + }, + "pointwiseMetricSpec": { # Spec for pointwise metric. # Spec for pointwise metric. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. By default, metrics return a score and explanation. When this config is set, the default output is replaced with either: - The raw output string. - A parsed output based on a user-defined schema. If a custom format is chosen, the `score` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pointwise metric. + "systemInstruction": "A String", # Optional. System instructions for pointwise metric. + }, + "rougeSpec": { # Spec for rouge score metric - calculates the recall of n-grams in prediction as compared to reference - returns a score ranging between 0 and 1. # Spec for rouge metric. + "rougeType": "A String", # Optional. Supported rouge types are rougen[1-9], rougeL, and rougeLsum. + "splitSummaries": True or False, # Optional. Whether to split summaries while using rougeLsum. + "useStemmer": True or False, # Optional. Whether to use stemmer to compute rouge score. + }, + }, + ], + "outputConfig": { # Config for evaluation output. # Required. Config for evaluation output. + "gcsDestination": { # The Google Cloud Storage location where the output is to be written to. # Cloud storage destination for evaluation output. + "outputUriPrefix": "A String", # Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist. + }, + }, + }, "hyperParameters": { # Hyperparameters for Preference Optimization. # Optional. Hyperparameters for Preference Optimization. "adapterSize": "A String", # Optional. Adapter size for preference optimization. "beta": 3.14, # Optional. Weight for KL Divergence regularization. @@ -1227,6 +1523,51 @@

Method Details

"startTime": "A String", # Output only. Time when the TuningJob for the first time entered the `JOB_STATE_RUNNING` state. "state": "A String", # Output only. The detailed state of the job. "supervisedTuningSpec": { # Tuning Spec for Supervised Tuning for first party models. # Tuning Spec for Supervised Fine Tuning. + "evaluationConfig": { # Evaluation Config for Tuning Job. # Optional. Evaluation Config for Tuning Job. + "autoraterConfig": { # The configs for autorater. This is applicable to both EvaluateInstances and EvaluateDataset. # Optional. Autorater config for evaluation. + "autoraterModel": "A String", # Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}` + "flipEnabled": True or False, # Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias. + "samplingCount": 42, # Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32. + }, + "metrics": [ # Required. The metrics used for evaluation. + { # The metric used for running evaluations. + "aggregationMetrics": [ # Optional. The aggregation metrics to use. + "A String", + ], + "bleuSpec": { # Spec for bleu score metric - calculates the precision of n-grams in the prediction as compared to reference - returns a score ranging between 0 to 1. # Spec for bleu metric. + "useEffectiveOrder": True or False, # Optional. Whether to use_effective_order to compute bleu score. + }, + "exactMatchSpec": { # Spec for exact match metric - returns 1 if prediction and reference exactly matches, otherwise 0. # Spec for exact match metric. + }, + "pairwiseMetricSpec": { # Spec for pairwise metric. # Spec for pairwise metric. + "baselineResponseFieldName": "A String", # Optional. The field name of the baseline response. + "candidateResponseFieldName": "A String", # Optional. The field name of the candidate response. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. When this config is set, the default output is replaced with the raw output string. If a custom format is chosen, the `pairwise_choice` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pairwise metric. + "systemInstruction": "A String", # Optional. System instructions for pairwise metric. + }, + "pointwiseMetricSpec": { # Spec for pointwise metric. # Spec for pointwise metric. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. By default, metrics return a score and explanation. When this config is set, the default output is replaced with either: - The raw output string. - A parsed output based on a user-defined schema. If a custom format is chosen, the `score` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pointwise metric. + "systemInstruction": "A String", # Optional. System instructions for pointwise metric. + }, + "rougeSpec": { # Spec for rouge score metric - calculates the recall of n-grams in prediction as compared to reference - returns a score ranging between 0 and 1. # Spec for rouge metric. + "rougeType": "A String", # Optional. Supported rouge types are rougen[1-9], rougeL, and rougeLsum. + "splitSummaries": True or False, # Optional. Whether to split summaries while using rougeLsum. + "useStemmer": True or False, # Optional. Whether to use stemmer to compute rouge score. + }, + }, + ], + "outputConfig": { # Config for evaluation output. # Required. Config for evaluation output. + "gcsDestination": { # The Google Cloud Storage location where the output is to be written to. # Cloud storage destination for evaluation output. + "outputUriPrefix": "A String", # Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist. + }, + }, + }, "exportLastCheckpointOnly": True or False, # Optional. If set to true, disable intermediate checkpoints for SFT and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for SFT. Default is false. "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT. "adapterSize": "A String", # Optional. Adapter size for tuning. @@ -1255,6 +1596,12 @@

Method Details

"tuningDataStats": { # The tuning data statistic values for TuningJob. # Output only. The tuning data statistics associated with this TuningJob. "distillationDataStats": { # Statistics computed for datasets used for distillation. # Output only. Statistics for distillation. "trainingDatasetStats": { # Statistics computed over a tuning dataset. # Output only. Statistics computed for the training dataset. + "droppedExampleIndices": [ # Output only. A partial sample of the indices (starting from 1) of the dropped examples. + "A String", + ], + "droppedExampleReasons": [ # Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped. + "A String", + ], "totalBillableCharacterCount": "A String", # Output only. Number of billable characters in the tuning dataset. "totalTuningCharacterCount": "A String", # Output only. Number of tuning characters in the tuning dataset. "tuningDatasetExampleCount": "A String", # Output only. Number of examples in the tuning dataset. @@ -1359,6 +1706,12 @@

Method Details

}, }, "preferenceOptimizationDataStats": { # Statistics computed for datasets used for preference optimization. # Output only. Statistics for preference optimization. + "droppedExampleIndices": [ # Output only. A partial sample of the indices (starting from 1) of the dropped examples. + "A String", + ], + "droppedExampleReasons": [ # Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped. + "A String", + ], "scoreVariancePerExampleDistribution": { # Distribution computed over a tuning dataset. # Output only. Dataset distributions for scores variance per example. "buckets": [ # Output only. Defines the histogram bucket. { # Dataset bucket used to create a histogram for the distribution given a population of values. @@ -1647,6 +2000,7 @@

Method Details

}, }, }, + "tuningJobState": "A String", # Output only. The detail state of the tuning job (while the overall `JobState` is running). "updateTime": "A String", # Output only. Time when the TuningJob was most recently updated. "veoTuningSpec": { # Tuning Spec for Veo Model Tuning. # Tuning Spec for Veo Tuning. "hyperParameters": { # Hyperparameters for Veo. # Optional. Hyperparameters for Veo. @@ -1711,6 +2065,21 @@

Method Details

], "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. }, + "evaluateDatasetRuns": [ # Output only. Evaluation runs for the Tuning Job. + { # Evaluate Dataset Run Result for Tuning Job. + "checkpointId": "A String", # Output only. The checkpoint id used in the evaluation run. Only populated when evaluating checkpoints. + "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The error of the evaluation run if any. + "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. + }, + "operationName": "A String", # Output only. The operation ID of the evaluation run. Format: `projects/{project}/locations/{location}/operations/{operation_id}`. + }, + ], "experiment": "A String", # Output only. The Experiment associated with this TuningJob. "labels": { # Optional. The labels with user-defined metadata to organize TuningJob and generated resources such as Model and Endpoint. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. "a_key": "A String", @@ -1731,6 +2100,51 @@

Method Details

"tunedModelName": "A String", # The resource name of the Model. E.g., a model resource name with a specified version id or alias: `projects/{project}/locations/{location}/models/{model}@{version_id}` `projects/{project}/locations/{location}/models/{model}@{alias}` Or, omit the version id to use the default version: `projects/{project}/locations/{location}/models/{model}` }, "preferenceOptimizationSpec": { # Tuning Spec for Preference Optimization. # Tuning Spec for Preference Optimization. + "evaluationConfig": { # Evaluation Config for Tuning Job. # Optional. Evaluation Config for Preference Optimization Job. + "autoraterConfig": { # The configs for autorater. This is applicable to both EvaluateInstances and EvaluateDataset. # Optional. Autorater config for evaluation. + "autoraterModel": "A String", # Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}` + "flipEnabled": True or False, # Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias. + "samplingCount": 42, # Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32. + }, + "metrics": [ # Required. The metrics used for evaluation. + { # The metric used for running evaluations. + "aggregationMetrics": [ # Optional. The aggregation metrics to use. + "A String", + ], + "bleuSpec": { # Spec for bleu score metric - calculates the precision of n-grams in the prediction as compared to reference - returns a score ranging between 0 to 1. # Spec for bleu metric. + "useEffectiveOrder": True or False, # Optional. Whether to use_effective_order to compute bleu score. + }, + "exactMatchSpec": { # Spec for exact match metric - returns 1 if prediction and reference exactly matches, otherwise 0. # Spec for exact match metric. + }, + "pairwiseMetricSpec": { # Spec for pairwise metric. # Spec for pairwise metric. + "baselineResponseFieldName": "A String", # Optional. The field name of the baseline response. + "candidateResponseFieldName": "A String", # Optional. The field name of the candidate response. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. When this config is set, the default output is replaced with the raw output string. If a custom format is chosen, the `pairwise_choice` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pairwise metric. + "systemInstruction": "A String", # Optional. System instructions for pairwise metric. + }, + "pointwiseMetricSpec": { # Spec for pointwise metric. # Spec for pointwise metric. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. By default, metrics return a score and explanation. When this config is set, the default output is replaced with either: - The raw output string. - A parsed output based on a user-defined schema. If a custom format is chosen, the `score` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pointwise metric. + "systemInstruction": "A String", # Optional. System instructions for pointwise metric. + }, + "rougeSpec": { # Spec for rouge score metric - calculates the recall of n-grams in prediction as compared to reference - returns a score ranging between 0 and 1. # Spec for rouge metric. + "rougeType": "A String", # Optional. Supported rouge types are rougen[1-9], rougeL, and rougeLsum. + "splitSummaries": True or False, # Optional. Whether to split summaries while using rougeLsum. + "useStemmer": True or False, # Optional. Whether to use stemmer to compute rouge score. + }, + }, + ], + "outputConfig": { # Config for evaluation output. # Required. Config for evaluation output. + "gcsDestination": { # The Google Cloud Storage location where the output is to be written to. # Cloud storage destination for evaluation output. + "outputUriPrefix": "A String", # Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist. + }, + }, + }, "hyperParameters": { # Hyperparameters for Preference Optimization. # Optional. Hyperparameters for Preference Optimization. "adapterSize": "A String", # Optional. Adapter size for preference optimization. "beta": 3.14, # Optional. Weight for KL Divergence regularization. @@ -1746,6 +2160,51 @@

Method Details

"startTime": "A String", # Output only. Time when the TuningJob for the first time entered the `JOB_STATE_RUNNING` state. "state": "A String", # Output only. The detailed state of the job. "supervisedTuningSpec": { # Tuning Spec for Supervised Tuning for first party models. # Tuning Spec for Supervised Fine Tuning. + "evaluationConfig": { # Evaluation Config for Tuning Job. # Optional. Evaluation Config for Tuning Job. + "autoraterConfig": { # The configs for autorater. This is applicable to both EvaluateInstances and EvaluateDataset. # Optional. Autorater config for evaluation. + "autoraterModel": "A String", # Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}` + "flipEnabled": True or False, # Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias. + "samplingCount": 42, # Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32. + }, + "metrics": [ # Required. The metrics used for evaluation. + { # The metric used for running evaluations. + "aggregationMetrics": [ # Optional. The aggregation metrics to use. + "A String", + ], + "bleuSpec": { # Spec for bleu score metric - calculates the precision of n-grams in the prediction as compared to reference - returns a score ranging between 0 to 1. # Spec for bleu metric. + "useEffectiveOrder": True or False, # Optional. Whether to use_effective_order to compute bleu score. + }, + "exactMatchSpec": { # Spec for exact match metric - returns 1 if prediction and reference exactly matches, otherwise 0. # Spec for exact match metric. + }, + "pairwiseMetricSpec": { # Spec for pairwise metric. # Spec for pairwise metric. + "baselineResponseFieldName": "A String", # Optional. The field name of the baseline response. + "candidateResponseFieldName": "A String", # Optional. The field name of the candidate response. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. When this config is set, the default output is replaced with the raw output string. If a custom format is chosen, the `pairwise_choice` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pairwise metric. + "systemInstruction": "A String", # Optional. System instructions for pairwise metric. + }, + "pointwiseMetricSpec": { # Spec for pointwise metric. # Spec for pointwise metric. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. By default, metrics return a score and explanation. When this config is set, the default output is replaced with either: - The raw output string. - A parsed output based on a user-defined schema. If a custom format is chosen, the `score` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pointwise metric. + "systemInstruction": "A String", # Optional. System instructions for pointwise metric. + }, + "rougeSpec": { # Spec for rouge score metric - calculates the recall of n-grams in prediction as compared to reference - returns a score ranging between 0 and 1. # Spec for rouge metric. + "rougeType": "A String", # Optional. Supported rouge types are rougen[1-9], rougeL, and rougeLsum. + "splitSummaries": True or False, # Optional. Whether to split summaries while using rougeLsum. + "useStemmer": True or False, # Optional. Whether to use stemmer to compute rouge score. + }, + }, + ], + "outputConfig": { # Config for evaluation output. # Required. Config for evaluation output. + "gcsDestination": { # The Google Cloud Storage location where the output is to be written to. # Cloud storage destination for evaluation output. + "outputUriPrefix": "A String", # Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist. + }, + }, + }, "exportLastCheckpointOnly": True or False, # Optional. If set to true, disable intermediate checkpoints for SFT and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for SFT. Default is false. "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT. "adapterSize": "A String", # Optional. Adapter size for tuning. @@ -1774,6 +2233,12 @@

Method Details

"tuningDataStats": { # The tuning data statistic values for TuningJob. # Output only. The tuning data statistics associated with this TuningJob. "distillationDataStats": { # Statistics computed for datasets used for distillation. # Output only. Statistics for distillation. "trainingDatasetStats": { # Statistics computed over a tuning dataset. # Output only. Statistics computed for the training dataset. + "droppedExampleIndices": [ # Output only. A partial sample of the indices (starting from 1) of the dropped examples. + "A String", + ], + "droppedExampleReasons": [ # Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped. + "A String", + ], "totalBillableCharacterCount": "A String", # Output only. Number of billable characters in the tuning dataset. "totalTuningCharacterCount": "A String", # Output only. Number of tuning characters in the tuning dataset. "tuningDatasetExampleCount": "A String", # Output only. Number of examples in the tuning dataset. @@ -1878,6 +2343,12 @@

Method Details

}, }, "preferenceOptimizationDataStats": { # Statistics computed for datasets used for preference optimization. # Output only. Statistics for preference optimization. + "droppedExampleIndices": [ # Output only. A partial sample of the indices (starting from 1) of the dropped examples. + "A String", + ], + "droppedExampleReasons": [ # Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped. + "A String", + ], "scoreVariancePerExampleDistribution": { # Distribution computed over a tuning dataset. # Output only. Dataset distributions for scores variance per example. "buckets": [ # Output only. Defines the histogram bucket. { # Dataset bucket used to create a histogram for the distribution given a population of values. @@ -2166,6 +2637,7 @@

Method Details

}, }, }, + "tuningJobState": "A String", # Output only. The detail state of the tuning job (while the overall `JobState` is running). "updateTime": "A String", # Output only. Time when the TuningJob was most recently updated. "veoTuningSpec": { # Tuning Spec for Veo Model Tuning. # Tuning Spec for Veo Tuning. "hyperParameters": { # Hyperparameters for Veo. # Optional. Hyperparameters for Veo. @@ -2363,6 +2835,21 @@

Method Details

], "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. }, + "evaluateDatasetRuns": [ # Output only. Evaluation runs for the Tuning Job. + { # Evaluate Dataset Run Result for Tuning Job. + "checkpointId": "A String", # Output only. The checkpoint id used in the evaluation run. Only populated when evaluating checkpoints. + "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The error of the evaluation run if any. + "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. + }, + "operationName": "A String", # Output only. The operation ID of the evaluation run. Format: `projects/{project}/locations/{location}/operations/{operation_id}`. + }, + ], "experiment": "A String", # Output only. The Experiment associated with this TuningJob. "labels": { # Optional. The labels with user-defined metadata to organize TuningJob and generated resources such as Model and Endpoint. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. "a_key": "A String", @@ -2383,6 +2870,51 @@

Method Details

"tunedModelName": "A String", # The resource name of the Model. E.g., a model resource name with a specified version id or alias: `projects/{project}/locations/{location}/models/{model}@{version_id}` `projects/{project}/locations/{location}/models/{model}@{alias}` Or, omit the version id to use the default version: `projects/{project}/locations/{location}/models/{model}` }, "preferenceOptimizationSpec": { # Tuning Spec for Preference Optimization. # Tuning Spec for Preference Optimization. + "evaluationConfig": { # Evaluation Config for Tuning Job. # Optional. Evaluation Config for Preference Optimization Job. + "autoraterConfig": { # The configs for autorater. This is applicable to both EvaluateInstances and EvaluateDataset. # Optional. Autorater config for evaluation. + "autoraterModel": "A String", # Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}` + "flipEnabled": True or False, # Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias. + "samplingCount": 42, # Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32. + }, + "metrics": [ # Required. The metrics used for evaluation. + { # The metric used for running evaluations. + "aggregationMetrics": [ # Optional. The aggregation metrics to use. + "A String", + ], + "bleuSpec": { # Spec for bleu score metric - calculates the precision of n-grams in the prediction as compared to reference - returns a score ranging between 0 to 1. # Spec for bleu metric. + "useEffectiveOrder": True or False, # Optional. Whether to use_effective_order to compute bleu score. + }, + "exactMatchSpec": { # Spec for exact match metric - returns 1 if prediction and reference exactly matches, otherwise 0. # Spec for exact match metric. + }, + "pairwiseMetricSpec": { # Spec for pairwise metric. # Spec for pairwise metric. + "baselineResponseFieldName": "A String", # Optional. The field name of the baseline response. + "candidateResponseFieldName": "A String", # Optional. The field name of the candidate response. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. When this config is set, the default output is replaced with the raw output string. If a custom format is chosen, the `pairwise_choice` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pairwise metric. + "systemInstruction": "A String", # Optional. System instructions for pairwise metric. + }, + "pointwiseMetricSpec": { # Spec for pointwise metric. # Spec for pointwise metric. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. By default, metrics return a score and explanation. When this config is set, the default output is replaced with either: - The raw output string. - A parsed output based on a user-defined schema. If a custom format is chosen, the `score` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pointwise metric. + "systemInstruction": "A String", # Optional. System instructions for pointwise metric. + }, + "rougeSpec": { # Spec for rouge score metric - calculates the recall of n-grams in prediction as compared to reference - returns a score ranging between 0 and 1. # Spec for rouge metric. + "rougeType": "A String", # Optional. Supported rouge types are rougen[1-9], rougeL, and rougeLsum. + "splitSummaries": True or False, # Optional. Whether to split summaries while using rougeLsum. + "useStemmer": True or False, # Optional. Whether to use stemmer to compute rouge score. + }, + }, + ], + "outputConfig": { # Config for evaluation output. # Required. Config for evaluation output. + "gcsDestination": { # The Google Cloud Storage location where the output is to be written to. # Cloud storage destination for evaluation output. + "outputUriPrefix": "A String", # Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist. + }, + }, + }, "hyperParameters": { # Hyperparameters for Preference Optimization. # Optional. Hyperparameters for Preference Optimization. "adapterSize": "A String", # Optional. Adapter size for preference optimization. "beta": 3.14, # Optional. Weight for KL Divergence regularization. @@ -2398,6 +2930,51 @@

Method Details

"startTime": "A String", # Output only. Time when the TuningJob for the first time entered the `JOB_STATE_RUNNING` state. "state": "A String", # Output only. The detailed state of the job. "supervisedTuningSpec": { # Tuning Spec for Supervised Tuning for first party models. # Tuning Spec for Supervised Fine Tuning. + "evaluationConfig": { # Evaluation Config for Tuning Job. # Optional. Evaluation Config for Tuning Job. + "autoraterConfig": { # The configs for autorater. This is applicable to both EvaluateInstances and EvaluateDataset. # Optional. Autorater config for evaluation. + "autoraterModel": "A String", # Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}` + "flipEnabled": True or False, # Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias. + "samplingCount": 42, # Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32. + }, + "metrics": [ # Required. The metrics used for evaluation. + { # The metric used for running evaluations. + "aggregationMetrics": [ # Optional. The aggregation metrics to use. + "A String", + ], + "bleuSpec": { # Spec for bleu score metric - calculates the precision of n-grams in the prediction as compared to reference - returns a score ranging between 0 to 1. # Spec for bleu metric. + "useEffectiveOrder": True or False, # Optional. Whether to use_effective_order to compute bleu score. + }, + "exactMatchSpec": { # Spec for exact match metric - returns 1 if prediction and reference exactly matches, otherwise 0. # Spec for exact match metric. + }, + "pairwiseMetricSpec": { # Spec for pairwise metric. # Spec for pairwise metric. + "baselineResponseFieldName": "A String", # Optional. The field name of the baseline response. + "candidateResponseFieldName": "A String", # Optional. The field name of the candidate response. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. When this config is set, the default output is replaced with the raw output string. If a custom format is chosen, the `pairwise_choice` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pairwise metric. + "systemInstruction": "A String", # Optional. System instructions for pairwise metric. + }, + "pointwiseMetricSpec": { # Spec for pointwise metric. # Spec for pointwise metric. + "customOutputFormatConfig": { # Spec for custom output format configuration. # Optional. CustomOutputFormatConfig allows customization of metric output. By default, metrics return a score and explanation. When this config is set, the default output is replaced with either: - The raw output string. - A parsed output based on a user-defined schema. If a custom format is chosen, the `score` and `explanation` fields in the corresponding metric result will be empty. + "returnRawOutput": True or False, # Optional. Whether to return raw output. + }, + "metricPromptTemplate": "A String", # Required. Metric prompt template for pointwise metric. + "systemInstruction": "A String", # Optional. System instructions for pointwise metric. + }, + "rougeSpec": { # Spec for rouge score metric - calculates the recall of n-grams in prediction as compared to reference - returns a score ranging between 0 and 1. # Spec for rouge metric. + "rougeType": "A String", # Optional. Supported rouge types are rougen[1-9], rougeL, and rougeLsum. + "splitSummaries": True or False, # Optional. Whether to split summaries while using rougeLsum. + "useStemmer": True or False, # Optional. Whether to use stemmer to compute rouge score. + }, + }, + ], + "outputConfig": { # Config for evaluation output. # Required. Config for evaluation output. + "gcsDestination": { # The Google Cloud Storage location where the output is to be written to. # Cloud storage destination for evaluation output. + "outputUriPrefix": "A String", # Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist. + }, + }, + }, "exportLastCheckpointOnly": True or False, # Optional. If set to true, disable intermediate checkpoints for SFT and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for SFT. Default is false. "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT. "adapterSize": "A String", # Optional. Adapter size for tuning. @@ -2426,6 +3003,12 @@

Method Details

"tuningDataStats": { # The tuning data statistic values for TuningJob. # Output only. The tuning data statistics associated with this TuningJob. "distillationDataStats": { # Statistics computed for datasets used for distillation. # Output only. Statistics for distillation. "trainingDatasetStats": { # Statistics computed over a tuning dataset. # Output only. Statistics computed for the training dataset. + "droppedExampleIndices": [ # Output only. A partial sample of the indices (starting from 1) of the dropped examples. + "A String", + ], + "droppedExampleReasons": [ # Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped. + "A String", + ], "totalBillableCharacterCount": "A String", # Output only. Number of billable characters in the tuning dataset. "totalTuningCharacterCount": "A String", # Output only. Number of tuning characters in the tuning dataset. "tuningDatasetExampleCount": "A String", # Output only. Number of examples in the tuning dataset. @@ -2530,6 +3113,12 @@

Method Details

}, }, "preferenceOptimizationDataStats": { # Statistics computed for datasets used for preference optimization. # Output only. Statistics for preference optimization. + "droppedExampleIndices": [ # Output only. A partial sample of the indices (starting from 1) of the dropped examples. + "A String", + ], + "droppedExampleReasons": [ # Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped. + "A String", + ], "scoreVariancePerExampleDistribution": { # Distribution computed over a tuning dataset. # Output only. Dataset distributions for scores variance per example. "buckets": [ # Output only. Defines the histogram bucket. { # Dataset bucket used to create a histogram for the distribution given a population of values. @@ -2818,6 +3407,7 @@

Method Details

}, }, }, + "tuningJobState": "A String", # Output only. The detail state of the tuning job (while the overall `JobState` is running). "updateTime": "A String", # Output only. Time when the TuningJob was most recently updated. "veoTuningSpec": { # Tuning Spec for Veo Model Tuning. # Tuning Spec for Veo Tuning. "hyperParameters": { # Hyperparameters for Veo. # Optional. Hyperparameters for Veo. diff --git a/docs/dyn/aiplatform_v1beta1.publishers.models.html b/docs/dyn/aiplatform_v1beta1.publishers.models.html index 7fa5452c61b..057d2013857 100644 --- a/docs/dyn/aiplatform_v1beta1.publishers.models.html +++ b/docs/dyn/aiplatform_v1beta1.publishers.models.html @@ -839,6 +839,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -1245,6 +1249,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. @@ -2821,6 +2826,10 @@

Method Details

"labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter. "a_key": "A String", }, + "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied. + "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization. + "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization. + }, "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates. { # Safety settings. "category": "A String", # Required. Harm category. @@ -3227,6 +3236,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.html index 2c9db24fedd..ddd9104f310 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.html @@ -152,12 +152,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. @@ -286,12 +302,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. @@ -361,12 +393,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. @@ -441,12 +489,28 @@

Method Details

}, ], "deploymentSpec": { # The specification of a Reasoning Engine deployment. # Optional. The specification of a Reasoning Engine deployment. + "containerConcurrency": 42, # Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9. "env": [ # Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API. { # Represents an environment variable present in a Container or Python Module. "name": "A String", # Required. Name of the environment variable. Must be a valid C identifier. "value": "A String", # Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. }, ], + "maxInstances": 42, # Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. + "minInstances": 42, # Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. + "pscInterfaceConfig": { # Configuration for PSC-I. # Optional. Configuration for PSC-I. + "dnsPeeringConfigs": [ # Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project. + { # DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS. + "domain": "A String", # Required. The DNS name suffix of the zone being peered to, e.g., "my-internal-domain.corp.". Must end with a dot. + "targetNetwork": "A String", # Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible. + "targetProject": "A String", # Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project. + }, + ], + "networkAttachment": "A String", # Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I. + }, + "resourceLimits": { # Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {"cpu": "4", "memory": "4Gi"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits + "a_key": "A String", + }, "secretEnv": [ # Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent. { # Represents an environment variable where the value is a secret in Cloud Secret Manager. "name": "A String", # Required. Name of the secret environment variable. diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html index aed32ddeb89..59df77bf382 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html @@ -120,11 +120,13 @@

Method Details

"createTime": "A String", # Output only. Timestamp when this Memory was created. "description": "A String", # Optional. Description of the Memory. "displayName": "A String", # Optional. Display name of the Memory. + "expireTime": "A String", # Optional. Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input. "fact": "A String", # Required. Semantic knowledge extracted from the source content. "name": "A String", # Identifier. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}` "scope": { # Required. Immutable. The scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'. "a_key": "A String", }, + "ttl": "A String", # Optional. Input only. The TTL for this resource. The expiration time is computed: now + TTL. "updateTime": "A String", # Output only. Timestamp when this Memory was most recently updated. } @@ -320,11 +322,13 @@

Method Details

"createTime": "A String", # Output only. Timestamp when this Memory was created. "description": "A String", # Optional. Description of the Memory. "displayName": "A String", # Optional. Display name of the Memory. + "expireTime": "A String", # Optional. Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input. "fact": "A String", # Required. Semantic knowledge extracted from the source content. "name": "A String", # Identifier. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}` "scope": { # Required. Immutable. The scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'. "a_key": "A String", }, + "ttl": "A String", # Optional. Input only. The TTL for this resource. The expiration time is computed: now + TTL. "updateTime": "A String", # Output only. Timestamp when this Memory was most recently updated. } @@ -352,11 +356,13 @@

Method Details

"createTime": "A String", # Output only. Timestamp when this Memory was created. "description": "A String", # Optional. Description of the Memory. "displayName": "A String", # Optional. Display name of the Memory. + "expireTime": "A String", # Optional. Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input. "fact": "A String", # Required. Semantic knowledge extracted from the source content. "name": "A String", # Identifier. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}` "scope": { # Required. Immutable. The scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'. "a_key": "A String", }, + "ttl": "A String", # Optional. Input only. The TTL for this resource. The expiration time is computed: now + TTL. "updateTime": "A String", # Output only. Timestamp when this Memory was most recently updated. }, ], @@ -391,11 +397,13 @@

Method Details

"createTime": "A String", # Output only. Timestamp when this Memory was created. "description": "A String", # Optional. Description of the Memory. "displayName": "A String", # Optional. Display name of the Memory. + "expireTime": "A String", # Optional. Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input. "fact": "A String", # Required. Semantic knowledge extracted from the source content. "name": "A String", # Identifier. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}` "scope": { # Required. Immutable. The scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'. "a_key": "A String", }, + "ttl": "A String", # Optional. Input only. The TTL for this resource. The expiration time is computed: now + TTL. "updateTime": "A String", # Output only. Timestamp when this Memory was most recently updated. } @@ -469,11 +477,13 @@

Method Details

"createTime": "A String", # Output only. Timestamp when this Memory was created. "description": "A String", # Optional. Description of the Memory. "displayName": "A String", # Optional. Display name of the Memory. + "expireTime": "A String", # Optional. Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input. "fact": "A String", # Required. Semantic knowledge extracted from the source content. "name": "A String", # Identifier. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}` "scope": { # Required. Immutable. The scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'. "a_key": "A String", }, + "ttl": "A String", # Optional. Input only. The TTL for this resource. The expiration time is computed: now + TTL. "updateTime": "A String", # Output only. Timestamp when this Memory was most recently updated. }, }, diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html index 9460b2ca247..1acecf1a02d 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html @@ -207,6 +207,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html index 36a852b6185..f166cff0607 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html @@ -211,6 +211,7 @@

Method Details

"uri": "A String", # URI reference of the chunk. }, "retrievedContext": { # Chunk from context retrieved by the retrieval tools. # Grounding chunk from context retrieved by the retrieval tools. + "documentName": "A String", # Output only. The full document name for the referenced Vertex AI Search document. "ragChunk": { # A RagChunk includes the content of a chunk of a RagFile, and associated metadata. # Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. "pageSpan": { # Represents where the chunk starts and ends in the document. # If populated, represents where the chunk starts and ends in the document. "firstPage": 42, # Page where chunk starts in the document. Inclusive. 1-indexed. diff --git a/googleapiclient/discovery_cache/documents/aiplatform.v1.json b/googleapiclient/discovery_cache/documents/aiplatform.v1.json index e124798438e..afee63b665d 100644 --- a/googleapiclient/discovery_cache/documents/aiplatform.v1.json +++ b/googleapiclient/discovery_cache/documents/aiplatform.v1.json @@ -20286,7 +20286,7 @@ } } }, -"revision": "20250731", +"revision": "20250806", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -22338,6 +22338,7 @@ "PROHIBITED_CONTENT", "SPII", "MALFORMED_FUNCTION_CALL", +"MODEL_ARMOR", "IMAGE_SAFETY", "IMAGE_PROHIBITED_CONTENT", "IMAGE_RECITATION", @@ -22355,6 +22356,7 @@ "Token generation stopped for potentially containing prohibited content.", "Token generation stopped because the content potentially contains Sensitive Personally Identifiable Information (SPII).", "The function call generated by the model is invalid.", +"The model response was blocked by Model Armor.", "Token generation stopped because generated images has safety violations.", "Image generation stopped because generated images has other prohibited content.", "Image generation stopped due to recitation.", @@ -24463,13 +24465,22 @@ "description": "The endpoint config to use for the deployment.", "id": "GoogleCloudAiplatformV1DeployRequestEndpointConfig", "properties": { +"dedicatedEndpointDisabled": { +"description": "Optional. By default, if dedicated endpoint is enabled, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon. If this field is set to true, the dedicated endpoint will be disabled and the deployed model will be exposed through the shared DNS {region}-aiplatform.googleapis.com.", +"type": "boolean" +}, "dedicatedEndpointEnabled": { -"description": "Optional. If true, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon.", +"deprecated": true, +"description": "Optional. Deprecated. Use dedicated_endpoint_disabled instead. If true, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon.", "type": "boolean" }, "endpointDisplayName": { "description": "Optional. The user-specified display name of the endpoint. If not set, a default name will be used.", "type": "string" +}, +"endpointUserId": { +"description": "Optional. Immutable. The ID to use for endpoint, which will become the final component of the endpoint resource name. If not provided, Vertex AI will generate a value for this ID. If the first character is a letter, this value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The last character must be a letter or number. If the first character is a number, this value may be up to 9 characters, and valid characters are `[0-9]` with no leading zeros. When using HTTP/JSON, this field is populated based on a query string argument, such as `?endpoint_id=12345`. This is the fallback for fields that are not included in either the URI or the body.", +"type": "string" } }, "type": "object" @@ -28633,6 +28644,10 @@ "description": "Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.", "type": "object" }, +"modelArmorConfig": { +"$ref": "GoogleCloudAiplatformV1ModelArmorConfig", +"description": "Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied." +}, "safetySettings": { "description": "Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.", "items": { @@ -28710,6 +28725,7 @@ "OTHER", "BLOCKLIST", "PROHIBITED_CONTENT", +"MODEL_ARMOR", "IMAGE_SAFETY" ], "enumDescriptions": [ @@ -28718,6 +28734,7 @@ "Candidates blocked due to other reason.", "Candidates blocked due to the terms which are included from the terminology blocklist.", "Candidates blocked due to prohibited content.", +"The user prompt was blocked by Model Armor.", "Candidates blocked due to unsafe image generation content." ], "readOnly": true, @@ -29358,6 +29375,11 @@ "description": "Chunk from context retrieved by the retrieval tools.", "id": "GoogleCloudAiplatformV1GroundingChunkRetrievedContext", "properties": { +"documentName": { +"description": "Output only. The full document name for the referenced Vertex AI Search document.", +"readOnly": true, +"type": "string" +}, "ragChunk": { "$ref": "GoogleCloudAiplatformV1RagChunk", "description": "Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool." @@ -32361,6 +32383,21 @@ false }, "type": "object" }, +"GoogleCloudAiplatformV1ModelArmorConfig": { +"description": "Configuration for Model Armor integrations of prompt and responses.", +"id": "GoogleCloudAiplatformV1ModelArmorConfig", +"properties": { +"promptTemplateName": { +"description": "Optional. The name of the Model Armor template to use for prompt sanitization.", +"type": "string" +}, +"responseTemplateName": { +"description": "Optional. The name of the Model Armor template to use for response sanitization.", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1ModelBaseModelSource": { "description": "User input field to specify the base model source. Currently it only supports specifing the Model Garden models and Genie models.", "id": "GoogleCloudAiplatformV1ModelBaseModelSource", @@ -38062,6 +38099,11 @@ false "description": "The specification of a Reasoning Engine deployment.", "id": "GoogleCloudAiplatformV1ReasoningEngineSpecDeploymentSpec", "properties": { +"containerConcurrency": { +"description": "Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9.", +"format": "int32", +"type": "integer" +}, "env": { "description": "Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API.", "items": { @@ -38069,6 +38111,27 @@ false }, "type": "array" }, +"maxInstances": { +"description": "Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100.", +"format": "int32", +"type": "integer" +}, +"minInstances": { +"description": "Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1.", +"format": "int32", +"type": "integer" +}, +"pscInterfaceConfig": { +"$ref": "GoogleCloudAiplatformV1PscInterfaceConfig", +"description": "Optional. Configuration for PSC-I." +}, +"resourceLimits": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {\"cpu\": \"4\", \"memory\": \"4Gi\"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits", +"type": "object" +}, "secretEnv": { "description": "Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent.", "items": { diff --git a/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json b/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json index 8b0ad6255ff..61152aee958 100644 --- a/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json @@ -1446,6 +1446,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, +"recommendSpec": { +"description": "Gets a Model's spec recommendations. This API is called by UI, SDK, and internal.", +"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:recommendSpec", +"httpMethod": "POST", +"id": "aiplatform.projects.locations.recommendSpec", +"parameterOrder": [ +"parent" +], +"parameters": { +"parent": { +"description": "Required. The resource name of the Location from which to recommend specs. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1beta1/{+parent}:recommendSpec", +"request": { +"$ref": "GoogleCloudAiplatformV1beta1RecommendSpecRequest" +}, +"response": { +"$ref": "GoogleCloudAiplatformV1beta1RecommendSpecResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, "retrieveContexts": { "description": "Retrieves relevant contexts for a query.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:retrieveContexts", @@ -25348,7 +25376,7 @@ } } }, -"revision": "20250731", +"revision": "20250806", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -27589,6 +27617,7 @@ "PROHIBITED_CONTENT", "SPII", "MALFORMED_FUNCTION_CALL", +"MODEL_ARMOR", "IMAGE_SAFETY", "IMAGE_PROHIBITED_CONTENT", "IMAGE_RECITATION", @@ -27606,6 +27635,7 @@ "Token generation stopped for potentially containing prohibited content.", "Token generation stopped because the content potentially contains Sensitive Personally Identifiable Information (SPII).", "The function call generated by the model is invalid.", +"The model response was blocked by Model Armor.", "Token generation stopped because generated images has safety violations.", "Image generation stopped because generated images has other prohibited content.", "Image generation stopped due to recitation.", @@ -29479,6 +29509,23 @@ "description": "Statistics computed over a tuning dataset.", "id": "GoogleCloudAiplatformV1beta1DatasetStats", "properties": { +"droppedExampleIndices": { +"description": "Output only. A partial sample of the indices (starting from 1) of the dropped examples.", +"items": { +"format": "int64", +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"droppedExampleReasons": { +"description": "Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, "totalBillableCharacterCount": { "description": "Output only. Number of billable characters in the tuning dataset.", "format": "int64", @@ -29969,13 +30016,22 @@ "description": "The endpoint config to use for the deployment.", "id": "GoogleCloudAiplatformV1beta1DeployRequestEndpointConfig", "properties": { +"dedicatedEndpointDisabled": { +"description": "Optional. By default, if dedicated endpoint is enabled, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon. If this field is set to true, the dedicated endpoint will be disabled and the deployed model will be exposed through the shared DNS {region}-aiplatform.googleapis.com.", +"type": "boolean" +}, "dedicatedEndpointEnabled": { -"description": "Optional. If true, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon.", +"deprecated": true, +"description": "Optional. Deprecated. Use dedicated_endpoint_disabled instead. If true, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon.", "type": "boolean" }, "endpointDisplayName": { "description": "Optional. The user-specified display name of the endpoint. If not set, a default name will be used.", "type": "string" +}, +"endpointUserId": { +"description": "Optional. Immutable. The ID to use for endpoint, which will become the final component of the endpoint resource name. If not provided, Vertex AI will generate a value for this ID. If the first character is a letter, this value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The last character must be a letter or number. If the first character is a number, this value may be up to 9 characters, and valid characters are `[0-9]` with no leading zeros. When using HTTP/JSON, this field is populated based on a query string argument, such as `?endpoint_id=12345`. This is the fallback for fields that are not included in either the URI or the body.", +"type": "string" } }, "type": "object" @@ -30902,6 +30958,28 @@ }, "type": "object" }, +"GoogleCloudAiplatformV1beta1EvaluateDatasetRun": { +"description": "Evaluate Dataset Run Result for Tuning Job.", +"id": "GoogleCloudAiplatformV1beta1EvaluateDatasetRun", +"properties": { +"checkpointId": { +"description": "Output only. The checkpoint id used in the evaluation run. Only populated when evaluating checkpoints.", +"readOnly": true, +"type": "string" +}, +"error": { +"$ref": "GoogleRpcStatus", +"description": "Output only. The error of the evaluation run if any.", +"readOnly": true +}, +"operationName": { +"description": "Output only. The operation ID of the evaluation run. Format: `projects/{project}/locations/{location}/operations/{operation_id}`.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1beta1EvaluateInstancesRequest": { "description": "Request message for EvaluationService.EvaluateInstances.", "id": "GoogleCloudAiplatformV1beta1EvaluateInstancesRequest", @@ -31255,6 +31333,28 @@ }, "type": "object" }, +"GoogleCloudAiplatformV1beta1EvaluationConfig": { +"description": "Evaluation Config for Tuning Job.", +"id": "GoogleCloudAiplatformV1beta1EvaluationConfig", +"properties": { +"autoraterConfig": { +"$ref": "GoogleCloudAiplatformV1beta1AutoraterConfig", +"description": "Optional. Autorater config for evaluation." +}, +"metrics": { +"description": "Required. The metrics used for evaluation.", +"items": { +"$ref": "GoogleCloudAiplatformV1beta1Metric" +}, +"type": "array" +}, +"outputConfig": { +"$ref": "GoogleCloudAiplatformV1beta1OutputConfig", +"description": "Required. Config for evaluation output." +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1beta1EvaluationDataset": { "description": "The dataset used for evaluation.", "id": "GoogleCloudAiplatformV1beta1EvaluationDataset", @@ -35194,6 +35294,10 @@ "description": "Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.", "type": "object" }, +"modelArmorConfig": { +"$ref": "GoogleCloudAiplatformV1beta1ModelArmorConfig", +"description": "Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied." +}, "safetySettings": { "description": "Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.", "items": { @@ -35271,6 +35375,7 @@ "OTHER", "BLOCKLIST", "PROHIBITED_CONTENT", +"MODEL_ARMOR", "IMAGE_SAFETY" ], "enumDescriptions": [ @@ -35279,6 +35384,7 @@ "Candidates blocked due to other reason.", "Candidates blocked due to the terms which are included from the terminology blocklist.", "Candidates blocked due to prohibited content.", +"The user prompt was blocked by Model Armor.", "Candidates blocked due to unsafe image generation content." ], "readOnly": true, @@ -36047,6 +36153,11 @@ "description": "Chunk from context retrieved by the retrieval tools.", "id": "GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext", "properties": { +"documentName": { +"description": "Output only. The full document name for the referenced Vertex AI Search document.", +"readOnly": true, +"type": "string" +}, "ragChunk": { "$ref": "GoogleCloudAiplatformV1beta1RagChunk", "description": "Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool." @@ -38728,6 +38839,11 @@ false "description": "Optional. Display name of the Memory.", "type": "string" }, +"expireTime": { +"description": "Optional. Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input.", +"format": "google-datetime", +"type": "string" +}, "fact": { "description": "Required. Semantic knowledge extracted from the source content.", "type": "string" @@ -38743,6 +38859,11 @@ false "description": "Required. Immutable. The scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'.", "type": "object" }, +"ttl": { +"description": "Optional. Input only. The TTL for this resource. The expiration time is computed: now + TTL.", +"format": "google-duration", +"type": "string" +}, "updateTime": { "description": "Output only. Timestamp when this Memory was most recently updated.", "format": "google-datetime", @@ -39487,6 +39608,21 @@ false }, "type": "object" }, +"GoogleCloudAiplatformV1beta1ModelArmorConfig": { +"description": "Configuration for Model Armor integrations of prompt and responses.", +"id": "GoogleCloudAiplatformV1beta1ModelArmorConfig", +"properties": { +"promptTemplateName": { +"description": "Optional. The name of the Model Armor template to use for prompt sanitization.", +"type": "string" +}, +"responseTemplateName": { +"description": "Optional. The name of the Model Armor template to use for response sanitization.", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1beta1ModelBaseModelSource": { "description": "User input field to specify the base model source. Currently it only supports specifing the Model Garden models and Genie models.", "id": "GoogleCloudAiplatformV1beta1ModelBaseModelSource", @@ -44087,6 +44223,23 @@ false "description": "Statistics computed for datasets used for preference optimization.", "id": "GoogleCloudAiplatformV1beta1PreferenceOptimizationDataStats", "properties": { +"droppedExampleIndices": { +"description": "Output only. A partial sample of the indices (starting from 1) of the dropped examples.", +"items": { +"format": "int64", +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"droppedExampleReasons": { +"description": "Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, "scoreVariancePerExampleDistribution": { "$ref": "GoogleCloudAiplatformV1beta1DatasetDistribution", "description": "Output only. Dataset distributions for scores variance per example.", @@ -44184,6 +44337,10 @@ false "description": "Tuning Spec for Preference Optimization.", "id": "GoogleCloudAiplatformV1beta1PreferenceOptimizationSpec", "properties": { +"evaluationConfig": { +"$ref": "GoogleCloudAiplatformV1beta1EvaluationConfig", +"description": "Optional. Evaluation Config for Preference Optimization Job." +}, "hyperParameters": { "$ref": "GoogleCloudAiplatformV1beta1PreferenceOptimizationHyperParameters", "description": "Optional. Hyperparameters for Preference Optimization." @@ -45604,7 +45761,7 @@ false "description": "Optional. Immutable. The embedding model config of the RagCorpus." }, "ragFilesCount": { -"description": "Output only. Number of RagFiles in the RagCorpus.", +"description": "Output only. Number of RagFiles in the RagCorpus. NOTE: This field is not populated in the response of VertexRagDataService.ListRagCorpora.", "format": "int32", "readOnly": true, "type": "integer" @@ -46743,6 +46900,11 @@ false "description": "The specification of a Reasoning Engine deployment.", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpec", "properties": { +"containerConcurrency": { +"description": "Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9.", +"format": "int32", +"type": "integer" +}, "env": { "description": "Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API.", "items": { @@ -46750,6 +46912,27 @@ false }, "type": "array" }, +"maxInstances": { +"description": "Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100.", +"format": "int32", +"type": "integer" +}, +"minInstances": { +"description": "Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1.", +"format": "int32", +"type": "integer" +}, +"pscInterfaceConfig": { +"$ref": "GoogleCloudAiplatformV1beta1PscInterfaceConfig", +"description": "Optional. Configuration for PSC-I." +}, +"resourceLimits": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {\"cpu\": \"4\", \"memory\": \"4Gi\"}. * The only supported values for CPU are '1', '2', '4', and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits", +"type": "object" +}, "secretEnv": { "description": "Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent.", "items": { @@ -46827,6 +47010,101 @@ false "properties": {}, "type": "object" }, +"GoogleCloudAiplatformV1beta1RecommendSpecRequest": { +"description": "Request message for ModelService.RecommendSpec.", +"id": "GoogleCloudAiplatformV1beta1RecommendSpecRequest", +"properties": { +"checkMachineAvailability": { +"description": "Optional. If true, check machine availability for the recommended regions. Only return the machine spec in regions where the machine is available.", +"type": "boolean" +}, +"checkUserQuota": { +"description": "Optional. If true, check user quota for the recommended regions. Returns all the machine spec in regions they are available, and also the user quota state for each machine type in each region.", +"type": "boolean" +}, +"gcsUri": { +"description": "Required. 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" +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1beta1RecommendSpecResponse": { +"description": "Response message for ModelService.RecommendSpec.", +"id": "GoogleCloudAiplatformV1beta1RecommendSpecResponse", +"properties": { +"baseModel": { +"description": "Output only. The base model used to finetune the custom model.", +"readOnly": true, +"type": "string" +}, +"recommendations": { +"description": "Output only. Recommendations of deployment options for the given custom weights model.", +"items": { +"$ref": "GoogleCloudAiplatformV1beta1RecommendSpecResponseRecommendation" +}, +"readOnly": true, +"type": "array" +}, +"specs": { +"description": "Output only. The machine and model container specs.", +"items": { +"$ref": "GoogleCloudAiplatformV1beta1RecommendSpecResponseMachineAndModelContainerSpec" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1beta1RecommendSpecResponseMachineAndModelContainerSpec": { +"description": "A machine and model container spec.", +"id": "GoogleCloudAiplatformV1beta1RecommendSpecResponseMachineAndModelContainerSpec", +"properties": { +"containerSpec": { +"$ref": "GoogleCloudAiplatformV1beta1ModelContainerSpec", +"description": "Output only. The model container spec.", +"readOnly": true +}, +"machineSpec": { +"$ref": "GoogleCloudAiplatformV1beta1MachineSpec", +"description": "Output only. The machine spec.", +"readOnly": true +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1beta1RecommendSpecResponseRecommendation": { +"description": "Recommendation of one deployment option for the given custom weights model in one region. Contains the machine and container spec, and user accelerator quota state.", +"id": "GoogleCloudAiplatformV1beta1RecommendSpecResponseRecommendation", +"properties": { +"region": { +"description": "The region for the deployment spec (machine).", +"type": "string" +}, +"spec": { +"$ref": "GoogleCloudAiplatformV1beta1RecommendSpecResponseMachineAndModelContainerSpec", +"description": "Output only. The machine and model container specs.", +"readOnly": true +}, +"userQuotaState": { +"description": "Output only. The user accelerator quota state.", +"enum": [ +"QUOTA_STATE_UNSPECIFIED", +"QUOTA_STATE_USER_HAS_QUOTA", +"QUOTA_STATE_NO_USER_QUOTA" +], +"enumDescriptions": [ +"Unspecified quota state. Quota information not available.", +"User has enough accelerator quota for the machine type.", +"User does not have enough accelerator quota for the machine type." +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1beta1RemoveContextChildrenRequest": { "description": "Request message for MetadataService.DeleteContextChildrenRequest.", "id": "GoogleCloudAiplatformV1beta1RemoveContextChildrenRequest", @@ -54712,6 +54990,10 @@ false "description": "Tuning Spec for Supervised Tuning for first party models.", "id": "GoogleCloudAiplatformV1beta1SupervisedTuningSpec", "properties": { +"evaluationConfig": { +"$ref": "GoogleCloudAiplatformV1beta1EvaluationConfig", +"description": "Optional. Evaluation Config for Tuning Job." +}, "exportLastCheckpointOnly": { "description": "Optional. If set to true, disable intermediate checkpoints for SFT and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for SFT. Default is false.", "type": "boolean" @@ -56563,6 +56845,14 @@ false "description": "Output only. Only populated when job's state is `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "readOnly": true }, +"evaluateDatasetRuns": { +"description": "Output only. Evaluation runs for the Tuning Job.", +"items": { +"$ref": "GoogleCloudAiplatformV1beta1EvaluateDatasetRun" +}, +"readOnly": true, +"type": "array" +}, "experiment": { "description": "Output only. The Experiment associated with this TuningJob.", "readOnly": true, @@ -56673,6 +56963,27 @@ false "description": "Output only. The tuning data statistics associated with this TuningJob.", "readOnly": true }, +"tuningJobState": { +"description": "Output only. The detail state of the tuning job (while the overall `JobState` is running).", +"enum": [ +"TUNING_JOB_STATE_UNSPECIFIED", +"TUNING_JOB_STATE_WAITING_FOR_QUOTA", +"TUNING_JOB_STATE_PROCESSING_DATASET", +"TUNING_JOB_STATE_WAITING_FOR_CAPACITY", +"TUNING_JOB_STATE_TUNING", +"TUNING_JOB_STATE_POST_PROCESSING" +], +"enumDescriptions": [ +"Default tuning job state.", +"Tuning job is waiting for job quota.", +"Tuning job is validating the dataset.", +"Tuning job is waiting for hardware capacity.", +"Tuning job is running.", +"Tuning job is doing some post processing steps." +], +"readOnly": true, +"type": "string" +}, "updateTime": { "description": "Output only. Time when the TuningJob was most recently updated.", "format": "google-datetime", From 4a2d6048b1dfb588990739aec87ed71fe6444167 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:58 +0000 Subject: [PATCH 04/32] feat(alloydb): update the api #### alloydb:v1 The following keys were added: - schemas.StorageDatabasecenterPartnerapiV1mainBackupDRMetadata (Total Keys: 9) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed.properties.backupdrMetadata.$ref (Total Keys: 1) #### alloydb:v1alpha The following keys were added: - schemas.StorageDatabasecenterPartnerapiV1mainBackupDRMetadata (Total Keys: 9) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed.properties.backupdrMetadata.$ref (Total Keys: 1) #### alloydb:v1beta The following keys were added: - schemas.StorageDatabasecenterPartnerapiV1mainBackupDRMetadata (Total Keys: 9) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed.properties.backupdrMetadata.$ref (Total Keys: 1) --- .../discovery_cache/documents/alloydb.v1.json | 60 ++++++++++++++++--- .../documents/alloydb.v1alpha.json | 60 ++++++++++++++++--- .../documents/alloydb.v1beta.json | 60 ++++++++++++++++--- 3 files changed, 156 insertions(+), 24 deletions(-) diff --git a/googleapiclient/discovery_cache/documents/alloydb.v1.json b/googleapiclient/discovery_cache/documents/alloydb.v1.json index 4856e7a863c..c75da4a6ffc 100644 --- a/googleapiclient/discovery_cache/documents/alloydb.v1.json +++ b/googleapiclient/discovery_cache/documents/alloydb.v1.json @@ -1622,7 +1622,7 @@ } } }, -"revision": "20250723", +"revision": "20250731", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -4102,6 +4102,38 @@ false }, "type": "object" }, +"StorageDatabasecenterPartnerapiV1mainBackupDRMetadata": { +"description": "BackupDRMetadata contains information about the backup and disaster recovery metadata of a database resource.", +"id": "StorageDatabasecenterPartnerapiV1mainBackupDRMetadata", +"properties": { +"backupConfiguration": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupConfiguration", +"description": "Backup configuration for this instance." +}, +"backupRun": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", +"description": "Latest backup run information for this instance." +}, +"backupdrConfiguration": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration", +"description": "BackupDR configuration for this instance." +}, +"fullResourceName": { +"description": "Required. Full resource name of this instance.", +"type": "string" +}, +"lastRefreshTime": { +"description": "Required. Last time backup configuration was refreshed.", +"format": "google-datetime", +"type": "string" +}, +"resourceId": { +"$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId", +"description": "Required. Database resource id." +} +}, +"type": "object" +}, "StorageDatabasecenterPartnerapiV1mainBackupRun": { "description": "A backup run.", "id": "StorageDatabasecenterPartnerapiV1mainBackupRun", @@ -4211,9 +4243,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: 9", +"description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 10", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed", "properties": { +"backupdrMetadata": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupDRMetadata", +"description": "BackupDR metadata is used to ingest metadata from BackupDR." +}, "configBasedSignalData": { "$ref": "StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData", "description": "Config based signal data is used to ingest signals that are generated based on the configuration of the database resource." @@ -4231,7 +4267,8 @@ false "OBSERVABILITY_DATA", "SECURITY_FINDING_DATA", "RECOMMENDATION_SIGNAL_DATA", -"CONFIG_BASED_SIGNAL_DATA" +"CONFIG_BASED_SIGNAL_DATA", +"BACKUPDR_METADATA" ], "enumDescriptions": [ "", @@ -4239,7 +4276,8 @@ false "Database resource monitoring data", "Database resource security health signal data", "Database resource recommendation signal data", -"Database config based signal data" +"Database config based signal data", +"Database resource metadata from BackupDR" ], "type": "string" }, @@ -4478,7 +4516,8 @@ false "SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", "SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", "SIGNAL_TYPE_REPLICATION_LAG", -"SIGNAL_TYPE_OUTDATED_VERSION" +"SIGNAL_TYPE_OUTDATED_VERSION", +"SIGNAL_TYPE_OUTDATED_CLIENT" ], "enumDeprecated": [ false, @@ -4581,6 +4620,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -4684,7 +4724,8 @@ false "Schema not optimized.", "High number of idle connections.", "Replication delay.", -"Outdated version." +"Outdated version.", +"Outdated client." ], "type": "string" }, @@ -5111,7 +5152,8 @@ false "SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", "SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", "SIGNAL_TYPE_REPLICATION_LAG", -"SIGNAL_TYPE_OUTDATED_VERSION" +"SIGNAL_TYPE_OUTDATED_VERSION", +"SIGNAL_TYPE_OUTDATED_CLIENT" ], "enumDeprecated": [ false, @@ -5214,6 +5256,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -5317,7 +5360,8 @@ false "Schema not optimized.", "High number of idle connections.", "Replication delay.", -"Outdated version." +"Outdated version.", +"Outdated client." ], "type": "string" } diff --git a/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json b/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json index ab8f5b15579..6cfddc00aa0 100644 --- a/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json @@ -1622,7 +1622,7 @@ } } }, -"revision": "20250723", +"revision": "20250731", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -4279,6 +4279,38 @@ false }, "type": "object" }, +"StorageDatabasecenterPartnerapiV1mainBackupDRMetadata": { +"description": "BackupDRMetadata contains information about the backup and disaster recovery metadata of a database resource.", +"id": "StorageDatabasecenterPartnerapiV1mainBackupDRMetadata", +"properties": { +"backupConfiguration": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupConfiguration", +"description": "Backup configuration for this instance." +}, +"backupRun": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", +"description": "Latest backup run information for this instance." +}, +"backupdrConfiguration": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration", +"description": "BackupDR configuration for this instance." +}, +"fullResourceName": { +"description": "Required. Full resource name of this instance.", +"type": "string" +}, +"lastRefreshTime": { +"description": "Required. Last time backup configuration was refreshed.", +"format": "google-datetime", +"type": "string" +}, +"resourceId": { +"$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId", +"description": "Required. Database resource id." +} +}, +"type": "object" +}, "StorageDatabasecenterPartnerapiV1mainBackupRun": { "description": "A backup run.", "id": "StorageDatabasecenterPartnerapiV1mainBackupRun", @@ -4388,9 +4420,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: 9", +"description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 10", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed", "properties": { +"backupdrMetadata": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupDRMetadata", +"description": "BackupDR metadata is used to ingest metadata from BackupDR." +}, "configBasedSignalData": { "$ref": "StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData", "description": "Config based signal data is used to ingest signals that are generated based on the configuration of the database resource." @@ -4408,7 +4444,8 @@ false "OBSERVABILITY_DATA", "SECURITY_FINDING_DATA", "RECOMMENDATION_SIGNAL_DATA", -"CONFIG_BASED_SIGNAL_DATA" +"CONFIG_BASED_SIGNAL_DATA", +"BACKUPDR_METADATA" ], "enumDescriptions": [ "", @@ -4416,7 +4453,8 @@ false "Database resource monitoring data", "Database resource security health signal data", "Database resource recommendation signal data", -"Database config based signal data" +"Database config based signal data", +"Database resource metadata from BackupDR" ], "type": "string" }, @@ -4655,7 +4693,8 @@ false "SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", "SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", "SIGNAL_TYPE_REPLICATION_LAG", -"SIGNAL_TYPE_OUTDATED_VERSION" +"SIGNAL_TYPE_OUTDATED_VERSION", +"SIGNAL_TYPE_OUTDATED_CLIENT" ], "enumDeprecated": [ false, @@ -4758,6 +4797,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -4861,7 +4901,8 @@ false "Schema not optimized.", "High number of idle connections.", "Replication delay.", -"Outdated version." +"Outdated version.", +"Outdated client." ], "type": "string" }, @@ -5288,7 +5329,8 @@ false "SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", "SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", "SIGNAL_TYPE_REPLICATION_LAG", -"SIGNAL_TYPE_OUTDATED_VERSION" +"SIGNAL_TYPE_OUTDATED_VERSION", +"SIGNAL_TYPE_OUTDATED_CLIENT" ], "enumDeprecated": [ false, @@ -5391,6 +5433,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -5494,7 +5537,8 @@ false "Schema not optimized.", "High number of idle connections.", "Replication delay.", -"Outdated version." +"Outdated version.", +"Outdated client." ], "type": "string" } diff --git a/googleapiclient/discovery_cache/documents/alloydb.v1beta.json b/googleapiclient/discovery_cache/documents/alloydb.v1beta.json index 1b01da82dfe..b9f558ba8d3 100644 --- a/googleapiclient/discovery_cache/documents/alloydb.v1beta.json +++ b/googleapiclient/discovery_cache/documents/alloydb.v1beta.json @@ -1619,7 +1619,7 @@ } } }, -"revision": "20250723", +"revision": "20250731", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -4255,6 +4255,38 @@ false }, "type": "object" }, +"StorageDatabasecenterPartnerapiV1mainBackupDRMetadata": { +"description": "BackupDRMetadata contains information about the backup and disaster recovery metadata of a database resource.", +"id": "StorageDatabasecenterPartnerapiV1mainBackupDRMetadata", +"properties": { +"backupConfiguration": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupConfiguration", +"description": "Backup configuration for this instance." +}, +"backupRun": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", +"description": "Latest backup run information for this instance." +}, +"backupdrConfiguration": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration", +"description": "BackupDR configuration for this instance." +}, +"fullResourceName": { +"description": "Required. Full resource name of this instance.", +"type": "string" +}, +"lastRefreshTime": { +"description": "Required. Last time backup configuration was refreshed.", +"format": "google-datetime", +"type": "string" +}, +"resourceId": { +"$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId", +"description": "Required. Database resource id." +} +}, +"type": "object" +}, "StorageDatabasecenterPartnerapiV1mainBackupRun": { "description": "A backup run.", "id": "StorageDatabasecenterPartnerapiV1mainBackupRun", @@ -4364,9 +4396,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: 9", +"description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 10", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed", "properties": { +"backupdrMetadata": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupDRMetadata", +"description": "BackupDR metadata is used to ingest metadata from BackupDR." +}, "configBasedSignalData": { "$ref": "StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData", "description": "Config based signal data is used to ingest signals that are generated based on the configuration of the database resource." @@ -4384,7 +4420,8 @@ false "OBSERVABILITY_DATA", "SECURITY_FINDING_DATA", "RECOMMENDATION_SIGNAL_DATA", -"CONFIG_BASED_SIGNAL_DATA" +"CONFIG_BASED_SIGNAL_DATA", +"BACKUPDR_METADATA" ], "enumDescriptions": [ "", @@ -4392,7 +4429,8 @@ false "Database resource monitoring data", "Database resource security health signal data", "Database resource recommendation signal data", -"Database config based signal data" +"Database config based signal data", +"Database resource metadata from BackupDR" ], "type": "string" }, @@ -4631,7 +4669,8 @@ false "SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", "SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", "SIGNAL_TYPE_REPLICATION_LAG", -"SIGNAL_TYPE_OUTDATED_VERSION" +"SIGNAL_TYPE_OUTDATED_VERSION", +"SIGNAL_TYPE_OUTDATED_CLIENT" ], "enumDeprecated": [ false, @@ -4734,6 +4773,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -4837,7 +4877,8 @@ false "Schema not optimized.", "High number of idle connections.", "Replication delay.", -"Outdated version." +"Outdated version.", +"Outdated client." ], "type": "string" }, @@ -5264,7 +5305,8 @@ false "SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", "SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", "SIGNAL_TYPE_REPLICATION_LAG", -"SIGNAL_TYPE_OUTDATED_VERSION" +"SIGNAL_TYPE_OUTDATED_VERSION", +"SIGNAL_TYPE_OUTDATED_CLIENT" ], "enumDeprecated": [ false, @@ -5367,6 +5409,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -5470,7 +5513,8 @@ false "Schema not optimized.", "High number of idle connections.", "Replication delay.", -"Outdated version." +"Outdated version.", +"Outdated client." ], "type": "string" } From 29b8f22ff5b9fcc606593c41250c5b2415f29053 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:58 +0000 Subject: [PATCH 05/32] feat(analyticshub): update the api #### analyticshub:v1 The following keys were added: - resources.projects.resources.locations.resources.dataExchanges.resources.queryTemplates.methods.approve (Total Keys: 12) - resources.projects.resources.locations.resources.dataExchanges.resources.queryTemplates.methods.create (Total Keys: 14) - resources.projects.resources.locations.resources.dataExchanges.resources.queryTemplates.methods.delete (Total Keys: 11) - resources.projects.resources.locations.resources.dataExchanges.resources.queryTemplates.methods.get (Total Keys: 11) - resources.projects.resources.locations.resources.dataExchanges.resources.queryTemplates.methods.list (Total Keys: 16) - resources.projects.resources.locations.resources.dataExchanges.resources.queryTemplates.methods.patch (Total Keys: 15) - resources.projects.resources.locations.resources.dataExchanges.resources.queryTemplates.methods.submit (Total Keys: 12) - schemas.ApproveQueryTemplateRequest (Total Keys: 2) - schemas.ListQueryTemplatesResponse (Total Keys: 5) - schemas.QueryTemplate (Total Keys: 16) - schemas.Routine (Total Keys: 4) - schemas.SubmitQueryTemplateRequest (Total Keys: 2) --- ...b_v1.projects.locations.dataExchanges.html | 5 + ...ocations.dataExchanges.queryTemplates.html | 387 ++++++++++++++++++ .../documents/analyticshub.v1.json | 342 +++++++++++++++- 3 files changed, 733 insertions(+), 1 deletion(-) create mode 100644 docs/dyn/analyticshub_v1.projects.locations.dataExchanges.queryTemplates.html diff --git a/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.html b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.html index 768f6902721..0a6132b6bed 100644 --- a/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.html +++ b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.html @@ -79,6 +79,11 @@

Instance Methods

Returns the listings Resource.

+

+ queryTemplates() +

+

Returns the queryTemplates Resource.

+

close()

Close httplib2 connections.

diff --git a/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.queryTemplates.html b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.queryTemplates.html new file mode 100644 index 00000000000..3da77bc490e --- /dev/null +++ b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.queryTemplates.html @@ -0,0 +1,387 @@ + + + +

Analytics Hub API . projects . locations . dataExchanges . queryTemplates

+

Instance Methods

+

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

+

Approves a query template.

+

+ close()

+

Close httplib2 connections.

+

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

+

Creates a new QueryTemplate

+

+ delete(name, x__xgafv=None)

+

Deletes a query template.

+

+ get(name, x__xgafv=None)

+

Gets a QueryTemplate

+

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

+

Lists all QueryTemplates in a given project and location.

+

+ list_next()

+

Retrieves the next page of results.

+

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

+

Updates an existing QueryTemplate

+

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

+

Submits a query template for approval.

+

Method Details

+
+ approve(name, body=None, x__xgafv=None) + 
Approves a query template.
+
+Args:
+  name: string, Required. The resource path of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/myqueryTemplate`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Message for approving a QueryTemplate.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A query template is a container for sharing table-valued functions defined by contributors in a data clean room.
+  "createTime": "A String", # Output only. Timestamp when the QueryTemplate was created.
+  "description": "A String", # Optional. Short description of the QueryTemplate. The description must not contain Unicode non-characters and C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.
+  "displayName": "A String", # Required. Human-readable display name of the QueryTemplate. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes.
+  "documentation": "A String", # Optional. Documentation describing the QueryTemplate.
+  "name": "A String", # Output only. The resource name of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/456`
+  "primaryContact": "A String", # Optional. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "proposer": "A String", # Optional. Will be deprecated. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "routine": { # Represents a bigquery routine. # Optional. The routine associated with the QueryTemplate.
+    "definitionBody": "A String", # Optional. The definition body of the routine.
+    "routineType": "A String", # Required. The type of routine.
+  },
+  "state": "A String", # Output only. The QueryTemplate lifecycle state.
+  "updateTime": "A String", # Output only. Timestamp when the QueryTemplate was last modified.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ create(parent, body=None, queryTemplateId=None, x__xgafv=None) + 
Creates a new QueryTemplate
+
+Args:
+  parent: string, Required. The parent resource path of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/myQueryTemplate`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A query template is a container for sharing table-valued functions defined by contributors in a data clean room.
+  "createTime": "A String", # Output only. Timestamp when the QueryTemplate was created.
+  "description": "A String", # Optional. Short description of the QueryTemplate. The description must not contain Unicode non-characters and C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.
+  "displayName": "A String", # Required. Human-readable display name of the QueryTemplate. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes.
+  "documentation": "A String", # Optional. Documentation describing the QueryTemplate.
+  "name": "A String", # Output only. The resource name of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/456`
+  "primaryContact": "A String", # Optional. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "proposer": "A String", # Optional. Will be deprecated. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "routine": { # Represents a bigquery routine. # Optional. The routine associated with the QueryTemplate.
+    "definitionBody": "A String", # Optional. The definition body of the routine.
+    "routineType": "A String", # Required. The type of routine.
+  },
+  "state": "A String", # Output only. The QueryTemplate lifecycle state.
+  "updateTime": "A String", # Output only. Timestamp when the QueryTemplate was last modified.
+}
+
+  queryTemplateId: string, Required. The ID of the QueryTemplate to create. Must contain only Unicode letters, numbers (0-9), underscores (_). Max length: 100 bytes.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A query template is a container for sharing table-valued functions defined by contributors in a data clean room.
+  "createTime": "A String", # Output only. Timestamp when the QueryTemplate was created.
+  "description": "A String", # Optional. Short description of the QueryTemplate. The description must not contain Unicode non-characters and C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.
+  "displayName": "A String", # Required. Human-readable display name of the QueryTemplate. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes.
+  "documentation": "A String", # Optional. Documentation describing the QueryTemplate.
+  "name": "A String", # Output only. The resource name of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/456`
+  "primaryContact": "A String", # Optional. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "proposer": "A String", # Optional. Will be deprecated. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "routine": { # Represents a bigquery routine. # Optional. The routine associated with the QueryTemplate.
+    "definitionBody": "A String", # Optional. The definition body of the routine.
+    "routineType": "A String", # Required. The type of routine.
+  },
+  "state": "A String", # Output only. The QueryTemplate lifecycle state.
+  "updateTime": "A String", # Output only. Timestamp when the QueryTemplate was last modified.
+}
+
+ +
+ delete(name, x__xgafv=None) + 
Deletes a query template.
+
+Args:
+  name: string, Required. The resource path of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/myqueryTemplate`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
+}
+
+ +
+ get(name, x__xgafv=None) + 
Gets a QueryTemplate
+
+Args:
+  name: string, Required. The parent resource path of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/myqueryTemplate`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A query template is a container for sharing table-valued functions defined by contributors in a data clean room.
+  "createTime": "A String", # Output only. Timestamp when the QueryTemplate was created.
+  "description": "A String", # Optional. Short description of the QueryTemplate. The description must not contain Unicode non-characters and C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.
+  "displayName": "A String", # Required. Human-readable display name of the QueryTemplate. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes.
+  "documentation": "A String", # Optional. Documentation describing the QueryTemplate.
+  "name": "A String", # Output only. The resource name of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/456`
+  "primaryContact": "A String", # Optional. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "proposer": "A String", # Optional. Will be deprecated. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "routine": { # Represents a bigquery routine. # Optional. The routine associated with the QueryTemplate.
+    "definitionBody": "A String", # Optional. The definition body of the routine.
+    "routineType": "A String", # Required. The type of routine.
+  },
+  "state": "A String", # Output only. The QueryTemplate lifecycle state.
+  "updateTime": "A String", # Output only. Timestamp when the QueryTemplate was last modified.
+}
+
+ +
+ list(parent, pageSize=None, pageToken=None, x__xgafv=None) + 
Lists all QueryTemplates in a given project and location.
+
+Args:
+  parent: string, Required. The parent resource path of the QueryTemplates. e.g. `projects/myproject/locations/us/dataExchanges/123`. (required)
+  pageSize: integer, Optional. The maximum number of results to return in a single response page. Leverage the page tokens to iterate through the entire collection.
+  pageToken: string, Optional. Page token, returned by a previous call, to request the next page of results.
+  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 the list of QueryTemplates.
+  "nextPageToken": "A String", # A token to request the next page of results.
+  "queryTemplates": [ # The list of QueryTemplates.
+    { # A query template is a container for sharing table-valued functions defined by contributors in a data clean room.
+      "createTime": "A String", # Output only. Timestamp when the QueryTemplate was created.
+      "description": "A String", # Optional. Short description of the QueryTemplate. The description must not contain Unicode non-characters and C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.
+      "displayName": "A String", # Required. Human-readable display name of the QueryTemplate. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes.
+      "documentation": "A String", # Optional. Documentation describing the QueryTemplate.
+      "name": "A String", # Output only. The resource name of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/456`
+      "primaryContact": "A String", # Optional. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+      "proposer": "A String", # Optional. Will be deprecated. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+      "routine": { # Represents a bigquery routine. # Optional. The routine associated with the QueryTemplate.
+        "definitionBody": "A String", # Optional. The definition body of the routine.
+        "routineType": "A String", # Required. The type of routine.
+      },
+      "state": "A String", # Output only. The QueryTemplate lifecycle state.
+      "updateTime": "A String", # Output only. Timestamp when the QueryTemplate was last modified.
+    },
+  ],
+}
+
+ +
+ 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 QueryTemplate
+
+Args:
+  name: string, Output only. The resource name of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/456` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A query template is a container for sharing table-valued functions defined by contributors in a data clean room.
+  "createTime": "A String", # Output only. Timestamp when the QueryTemplate was created.
+  "description": "A String", # Optional. Short description of the QueryTemplate. The description must not contain Unicode non-characters and C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.
+  "displayName": "A String", # Required. Human-readable display name of the QueryTemplate. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes.
+  "documentation": "A String", # Optional. Documentation describing the QueryTemplate.
+  "name": "A String", # Output only. The resource name of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/456`
+  "primaryContact": "A String", # Optional. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "proposer": "A String", # Optional. Will be deprecated. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "routine": { # Represents a bigquery routine. # Optional. The routine associated with the QueryTemplate.
+    "definitionBody": "A String", # Optional. The definition body of the routine.
+    "routineType": "A String", # Required. The type of routine.
+  },
+  "state": "A String", # Output only. The QueryTemplate lifecycle state.
+  "updateTime": "A String", # Output only. Timestamp when the QueryTemplate was last modified.
+}
+
+  updateMask: string, Optional. Field mask specifies the fields to update in the query template resource. The fields specified in the `updateMask` are relative to the resource and are not a full request.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A query template is a container for sharing table-valued functions defined by contributors in a data clean room.
+  "createTime": "A String", # Output only. Timestamp when the QueryTemplate was created.
+  "description": "A String", # Optional. Short description of the QueryTemplate. The description must not contain Unicode non-characters and C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.
+  "displayName": "A String", # Required. Human-readable display name of the QueryTemplate. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes.
+  "documentation": "A String", # Optional. Documentation describing the QueryTemplate.
+  "name": "A String", # Output only. The resource name of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/456`
+  "primaryContact": "A String", # Optional. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "proposer": "A String", # Optional. Will be deprecated. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "routine": { # Represents a bigquery routine. # Optional. The routine associated with the QueryTemplate.
+    "definitionBody": "A String", # Optional. The definition body of the routine.
+    "routineType": "A String", # Required. The type of routine.
+  },
+  "state": "A String", # Output only. The QueryTemplate lifecycle state.
+  "updateTime": "A String", # Output only. Timestamp when the QueryTemplate was last modified.
+}
+
+ +
+ submit(name, body=None, x__xgafv=None) + 
Submits a query template for approval.
+
+Args:
+  name: string, Required. The resource path of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/myqueryTemplate`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Message for submitting a QueryTemplate.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A query template is a container for sharing table-valued functions defined by contributors in a data clean room.
+  "createTime": "A String", # Output only. Timestamp when the QueryTemplate was created.
+  "description": "A String", # Optional. Short description of the QueryTemplate. The description must not contain Unicode non-characters and C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.
+  "displayName": "A String", # Required. Human-readable display name of the QueryTemplate. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes.
+  "documentation": "A String", # Optional. Documentation describing the QueryTemplate.
+  "name": "A String", # Output only. The resource name of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/456`
+  "primaryContact": "A String", # Optional. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "proposer": "A String", # Optional. Will be deprecated. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.
+  "routine": { # Represents a bigquery routine. # Optional. The routine associated with the QueryTemplate.
+    "definitionBody": "A String", # Optional. The definition body of the routine.
+    "routineType": "A String", # Required. The type of routine.
+  },
+  "state": "A String", # Output only. The QueryTemplate lifecycle state.
+  "updateTime": "A String", # Output only. Timestamp when the QueryTemplate was last modified.
+}
+
+ + \ No newline at end of file diff --git a/googleapiclient/discovery_cache/documents/analyticshub.v1.json b/googleapiclient/discovery_cache/documents/analyticshub.v1.json index 73230601ea3..4367aeb7eea 100644 --- a/googleapiclient/discovery_cache/documents/analyticshub.v1.json +++ b/googleapiclient/discovery_cache/documents/analyticshub.v1.json @@ -805,6 +805,226 @@ ] } } +}, +"queryTemplates": { +"methods": { +"approve": { +"description": "Approves a query template.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataExchanges/{dataExchangesId}/queryTemplates/{queryTemplatesId}:approve", +"httpMethod": "POST", +"id": "analyticshub.projects.locations.dataExchanges.queryTemplates.approve", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource path of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/myqueryTemplate`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/dataExchanges/[^/]+/queryTemplates/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}:approve", +"request": { +"$ref": "ApproveQueryTemplateRequest" +}, +"response": { +"$ref": "QueryTemplate" +}, +"scopes": [ +"https://www.googleapis.com/auth/bigquery", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"create": { +"description": "Creates a new QueryTemplate", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataExchanges/{dataExchangesId}/queryTemplates", +"httpMethod": "POST", +"id": "analyticshub.projects.locations.dataExchanges.queryTemplates.create", +"parameterOrder": [ +"parent" +], +"parameters": { +"parent": { +"description": "Required. The parent resource path of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/myQueryTemplate`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/dataExchanges/[^/]+$", +"required": true, +"type": "string" +}, +"queryTemplateId": { +"description": "Required. The ID of the QueryTemplate to create. Must contain only Unicode letters, numbers (0-9), underscores (_). Max length: 100 bytes.", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+parent}/queryTemplates", +"request": { +"$ref": "QueryTemplate" +}, +"response": { +"$ref": "QueryTemplate" +}, +"scopes": [ +"https://www.googleapis.com/auth/bigquery", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"delete": { +"description": "Deletes a query template.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataExchanges/{dataExchangesId}/queryTemplates/{queryTemplatesId}", +"httpMethod": "DELETE", +"id": "analyticshub.projects.locations.dataExchanges.queryTemplates.delete", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource path of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/myqueryTemplate`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/dataExchanges/[^/]+/queryTemplates/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}", +"response": { +"$ref": "Empty" +}, +"scopes": [ +"https://www.googleapis.com/auth/bigquery", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"get": { +"description": "Gets a QueryTemplate", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataExchanges/{dataExchangesId}/queryTemplates/{queryTemplatesId}", +"httpMethod": "GET", +"id": "analyticshub.projects.locations.dataExchanges.queryTemplates.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The parent resource path of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/myqueryTemplate`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/dataExchanges/[^/]+/queryTemplates/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}", +"response": { +"$ref": "QueryTemplate" +}, +"scopes": [ +"https://www.googleapis.com/auth/bigquery", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"list": { +"description": "Lists all QueryTemplates in a given project and location.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataExchanges/{dataExchangesId}/queryTemplates", +"httpMethod": "GET", +"id": "analyticshub.projects.locations.dataExchanges.queryTemplates.list", +"parameterOrder": [ +"parent" +], +"parameters": { +"pageSize": { +"description": "Optional. The maximum number of results to return in a single response page. Leverage the page tokens to iterate through the entire collection.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "Optional. Page token, returned by a previous call, to request the next page of results.", +"location": "query", +"type": "string" +}, +"parent": { +"description": "Required. The parent resource path of the QueryTemplates. e.g. `projects/myproject/locations/us/dataExchanges/123`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/dataExchanges/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+parent}/queryTemplates", +"response": { +"$ref": "ListQueryTemplatesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/bigquery", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"patch": { +"description": "Updates an existing QueryTemplate", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataExchanges/{dataExchangesId}/queryTemplates/{queryTemplatesId}", +"httpMethod": "PATCH", +"id": "analyticshub.projects.locations.dataExchanges.queryTemplates.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Output only. The resource name of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/456`", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/dataExchanges/[^/]+/queryTemplates/[^/]+$", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Optional. Field mask specifies the fields to update in the query template resource. The fields specified in the `updateMask` are relative to the resource and are not a full request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "QueryTemplate" +}, +"response": { +"$ref": "QueryTemplate" +}, +"scopes": [ +"https://www.googleapis.com/auth/bigquery", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"submit": { +"description": "Submits a query template for approval.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataExchanges/{dataExchangesId}/queryTemplates/{queryTemplatesId}:submit", +"httpMethod": "POST", +"id": "analyticshub.projects.locations.dataExchanges.queryTemplates.submit", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource path of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/myqueryTemplate`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/dataExchanges/[^/]+/queryTemplates/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}:submit", +"request": { +"$ref": "SubmitQueryTemplateRequest" +}, +"response": { +"$ref": "QueryTemplate" +}, +"scopes": [ +"https://www.googleapis.com/auth/bigquery", +"https://www.googleapis.com/auth/cloud-platform" +] +} +} } } }, @@ -1027,9 +1247,15 @@ } } }, -"revision": "20250623", +"revision": "20250807", "rootUrl": "https://analyticshub.googleapis.com/", "schemas": { +"ApproveQueryTemplateRequest": { +"description": "Message for approving a QueryTemplate.", +"id": "ApproveQueryTemplateRequest", +"properties": {}, +"type": "object" +}, "AuditConfig": { "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "id": "AuditConfig", @@ -1684,6 +1910,24 @@ }, "type": "object" }, +"ListQueryTemplatesResponse": { +"description": "Message for response to the list of QueryTemplates.", +"id": "ListQueryTemplatesResponse", +"properties": { +"nextPageToken": { +"description": "A token to request the next page of results.", +"type": "string" +}, +"queryTemplates": { +"description": "The list of QueryTemplates.", +"items": { +"$ref": "QueryTemplate" +}, +"type": "array" +} +}, +"type": "object" +}, "ListSharedResourceSubscriptionsResponse": { "description": "Message for response to the listing of shared resource subscriptions.", "id": "ListSharedResourceSubscriptionsResponse", @@ -2110,6 +2354,73 @@ }, "type": "object" }, +"QueryTemplate": { +"description": "A query template is a container for sharing table-valued functions defined by contributors in a data clean room.", +"id": "QueryTemplate", +"properties": { +"createTime": { +"description": "Output only. Timestamp when the QueryTemplate was created.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "Optional. Short description of the QueryTemplate. The description must not contain Unicode non-characters and C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.", +"type": "string" +}, +"displayName": { +"description": "Required. Human-readable display name of the QueryTemplate. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes.", +"type": "string" +}, +"documentation": { +"description": "Optional. Documentation describing the QueryTemplate.", +"type": "string" +}, +"name": { +"description": "Output only. The resource name of the QueryTemplate. e.g. `projects/myproject/locations/us/dataExchanges/123/queryTemplates/456`", +"readOnly": true, +"type": "string" +}, +"primaryContact": { +"description": "Optional. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.", +"type": "string" +}, +"proposer": { +"description": "Optional. Will be deprecated. Email or URL of the primary point of contact of the QueryTemplate. Max Length: 1000 bytes.", +"type": "string" +}, +"routine": { +"$ref": "Routine", +"description": "Optional. The routine associated with the QueryTemplate." +}, +"state": { +"description": "Output only. The QueryTemplate lifecycle state.", +"enum": [ +"STATE_UNSPECIFIED", +"DRAFTED", +"PENDING", +"DELETED", +"APPROVED" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"The QueryTemplate is in draft state.", +"The QueryTemplate is in pending state.", +"The QueryTemplate is in deleted state.", +"The QueryTemplate is in approved state." +], +"readOnly": true, +"type": "string" +}, +"updateTime": { +"description": "Output only. Timestamp when the QueryTemplate was last modified.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "RefreshSubscriptionRequest": { "description": "Message for refreshing a subscription.", "id": "RefreshSubscriptionRequest", @@ -2200,6 +2511,29 @@ "properties": {}, "type": "object" }, +"Routine": { +"description": "Represents a bigquery routine.", +"id": "Routine", +"properties": { +"definitionBody": { +"description": "Optional. The definition body of the routine.", +"type": "string" +}, +"routineType": { +"description": "Required. The type of routine.", +"enum": [ +"ROUTINE_TYPE_UNSPECIFIED", +"TABLE_VALUED_FUNCTION" +], +"enumDescriptions": [ +"Default value.", +"Non-built-in persistent TVF." +], +"type": "string" +} +}, +"type": "object" +}, "SelectedResource": { "description": "Resource in this dataset that is selectively shared.", "id": "SelectedResource", @@ -2273,6 +2607,12 @@ }, "type": "object" }, +"SubmitQueryTemplateRequest": { +"description": "Message for submitting a QueryTemplate.", +"id": "SubmitQueryTemplateRequest", +"properties": {}, +"type": "object" +}, "SubscribeDataExchangeRequest": { "description": "Message for subscribing to a Data Exchange.", "id": "SubscribeDataExchangeRequest", From c6811af8c3b11cec8cdaba085da9c7d664c17caf Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:58 +0000 Subject: [PATCH 06/32] feat(androidpublisher): update the api #### androidpublisher:v3 The following keys were added: - schemas.DeferredItemRemoval (Total Keys: 2) - schemas.SubscriptionPurchaseLineItem.properties.deferredItemRemoval.$ref (Total Keys: 1) --- ...ndroidpublisher_v3.purchases.subscriptionsv2.html | 2 ++ .../documents/androidpublisher.v3.json | 12 +++++++++++- 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/dyn/androidpublisher_v3.purchases.subscriptionsv2.html b/docs/dyn/androidpublisher_v3.purchases.subscriptionsv2.html index 90278060a11..07e8e7f91fc 100644 --- a/docs/dyn/androidpublisher_v3.purchases.subscriptionsv2.html +++ b/docs/dyn/androidpublisher_v3.purchases.subscriptionsv2.html @@ -155,6 +155,8 @@

Method Details

"units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. }, }, + "deferredItemRemoval": { # Information related to deferred item replacement. # Information for deferred item removal. + }, "deferredItemReplacement": { # Information related to deferred item replacement. # Information for deferred item replacement. "productId": "A String", # The product_id going to replace the existing product_id. }, diff --git a/googleapiclient/discovery_cache/documents/androidpublisher.v3.json b/googleapiclient/discovery_cache/documents/androidpublisher.v3.json index 9e728fb04d8..e3256a27b12 100644 --- a/googleapiclient/discovery_cache/documents/androidpublisher.v3.json +++ b/googleapiclient/discovery_cache/documents/androidpublisher.v3.json @@ -5521,7 +5521,7 @@ } } }, -"revision": "20250724", +"revision": "20250807", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { @@ -7057,6 +7057,12 @@ }, "type": "object" }, +"DeferredItemRemoval": { +"description": "Information related to deferred item replacement.", +"id": "DeferredItemRemoval", +"properties": {}, +"type": "object" +}, "DeferredItemReplacement": { "description": "Information related to deferred item replacement.", "id": "DeferredItemReplacement", @@ -11319,6 +11325,10 @@ false "$ref": "AutoRenewingPlan", "description": "The item is auto renewing." }, +"deferredItemRemoval": { +"$ref": "DeferredItemRemoval", +"description": "Information for deferred item removal." +}, "deferredItemReplacement": { "$ref": "DeferredItemReplacement", "description": "Information for deferred item replacement." From 50535f80389dc4093e02842dc0ea7e30c14c1cd1 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:58 +0000 Subject: [PATCH 07/32] feat(apigee): update the api #### apigee:v1 The following keys were added: - schemas.GoogleCloudApigeeV1KeyValueMap.properties.maskedValues.type (Total Keys: 1) --- .../dyn/apigee_v1.organizations.apis.keyvaluemaps.html | 3 +++ docs/dyn/apigee_v1.organizations.apps.html | 4 ++-- ...gee_v1.organizations.environments.keyvaluemaps.html | 3 +++ docs/dyn/apigee_v1.organizations.keyvaluemaps.html | 3 +++ .../discovery_cache/documents/apigee.v1.json | 10 +++++++--- 5 files changed, 18 insertions(+), 5 deletions(-) diff --git a/docs/dyn/apigee_v1.organizations.apis.keyvaluemaps.html b/docs/dyn/apigee_v1.organizations.apis.keyvaluemaps.html index 0bc650acea5..2ecb17a525c 100644 --- a/docs/dyn/apigee_v1.organizations.apis.keyvaluemaps.html +++ b/docs/dyn/apigee_v1.organizations.apis.keyvaluemaps.html @@ -105,6 +105,7 @@

Method Details

{ # Collection of key/value string pairs. "encrypted": True or False, # Required. Flag that specifies whether entry values will be encrypted. This field is retained for backward compatibility and the value of encrypted will always be `true`. Apigee X and hybrid do not support unencrypted key value maps. + "maskedValues": True or False, # Required. Flag that specifies whether entry values will be masked when returned. "name": "A String", # Required. ID of the key value map. } @@ -118,6 +119,7 @@

Method Details

{ # Collection of key/value string pairs. "encrypted": True or False, # Required. Flag that specifies whether entry values will be encrypted. This field is retained for backward compatibility and the value of encrypted will always be `true`. Apigee X and hybrid do not support unencrypted key value maps. + "maskedValues": True or False, # Required. Flag that specifies whether entry values will be masked when returned. "name": "A String", # Required. ID of the key value map. } @@ -138,6 +140,7 @@

Method Details

{ # Collection of key/value string pairs. "encrypted": True or False, # Required. Flag that specifies whether entry values will be encrypted. This field is retained for backward compatibility and the value of encrypted will always be `true`. Apigee X and hybrid do not support unencrypted key value maps. + "maskedValues": True or False, # Required. Flag that specifies whether entry values will be masked when returned. "name": "A String", # Required. ID of the key value map. } diff --git a/docs/dyn/apigee_v1.organizations.apps.html b/docs/dyn/apigee_v1.organizations.apps.html index ab56f40c17f..77f68b21831 100644 --- a/docs/dyn/apigee_v1.organizations.apps.html +++ b/docs/dyn/apigee_v1.organizations.apps.html @@ -173,9 +173,9 @@

Method Details

ids: string, Optional. Comma-separated list of app IDs on which to filter. includeCred: boolean, Optional. Flag that specifies whether to include credentials in the response. keyStatus: string, Optional. Key status of the app. Valid values include `approved` or `revoked`. Defaults to `approved`. - pageSize: integer, Optional. Count of apps a single page can have in the response. If unspecified, at most 100 apps will be returned. The maximum value is 100; values above 100 will be coerced to 100. "page_size" is supported from ver 1.10.0 and above. + pageSize: integer, Optional. Count of apps a single page can have in the response. If unspecified, at most 1000 apps will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. "page_size" is supported from ver 1.10.0 and above. pageToken: string, Optional. The starting index record for listing the developers. "page_token" is supported from ver 1.10.0 and above. - rows: string, Optional. Maximum number of app IDs to return. Defaults to 1000. + rows: string, Optional. Maximum number of app IDs to return. Defaults to 1000, which is also the upper limit. To get more than 1000, use pagination with 'pageSize' and 'pageToken' parameters. startKey: string, Returns the list of apps starting from the specified app ID. status: string, Optional. Filter by the status of the app. Valid values are `approved` or `revoked`. Defaults to `approved`. x__xgafv: string, V1 error format. diff --git a/docs/dyn/apigee_v1.organizations.environments.keyvaluemaps.html b/docs/dyn/apigee_v1.organizations.environments.keyvaluemaps.html index 14f9006c9b6..4e322d4acc1 100644 --- a/docs/dyn/apigee_v1.organizations.environments.keyvaluemaps.html +++ b/docs/dyn/apigee_v1.organizations.environments.keyvaluemaps.html @@ -105,6 +105,7 @@

Method Details

{ # Collection of key/value string pairs. "encrypted": True or False, # Required. Flag that specifies whether entry values will be encrypted. This field is retained for backward compatibility and the value of encrypted will always be `true`. Apigee X and hybrid do not support unencrypted key value maps. + "maskedValues": True or False, # Required. Flag that specifies whether entry values will be masked when returned. "name": "A String", # Required. ID of the key value map. } @@ -118,6 +119,7 @@

Method Details

{ # Collection of key/value string pairs. "encrypted": True or False, # Required. Flag that specifies whether entry values will be encrypted. This field is retained for backward compatibility and the value of encrypted will always be `true`. Apigee X and hybrid do not support unencrypted key value maps. + "maskedValues": True or False, # Required. Flag that specifies whether entry values will be masked when returned. "name": "A String", # Required. ID of the key value map. } @@ -138,6 +140,7 @@

Method Details

{ # Collection of key/value string pairs. "encrypted": True or False, # Required. Flag that specifies whether entry values will be encrypted. This field is retained for backward compatibility and the value of encrypted will always be `true`. Apigee X and hybrid do not support unencrypted key value maps. + "maskedValues": True or False, # Required. Flag that specifies whether entry values will be masked when returned. "name": "A String", # Required. ID of the key value map. } diff --git a/docs/dyn/apigee_v1.organizations.keyvaluemaps.html b/docs/dyn/apigee_v1.organizations.keyvaluemaps.html index 76a827a8142..d85662a9fca 100644 --- a/docs/dyn/apigee_v1.organizations.keyvaluemaps.html +++ b/docs/dyn/apigee_v1.organizations.keyvaluemaps.html @@ -105,6 +105,7 @@

Method Details

{ # Collection of key/value string pairs. "encrypted": True or False, # Required. Flag that specifies whether entry values will be encrypted. This field is retained for backward compatibility and the value of encrypted will always be `true`. Apigee X and hybrid do not support unencrypted key value maps. + "maskedValues": True or False, # Required. Flag that specifies whether entry values will be masked when returned. "name": "A String", # Required. ID of the key value map. } @@ -118,6 +119,7 @@

Method Details

{ # Collection of key/value string pairs. "encrypted": True or False, # Required. Flag that specifies whether entry values will be encrypted. This field is retained for backward compatibility and the value of encrypted will always be `true`. Apigee X and hybrid do not support unencrypted key value maps. + "maskedValues": True or False, # Required. Flag that specifies whether entry values will be masked when returned. "name": "A String", # Required. ID of the key value map. } @@ -138,6 +140,7 @@

Method Details

{ # Collection of key/value string pairs. "encrypted": True or False, # Required. Flag that specifies whether entry values will be encrypted. This field is retained for backward compatibility and the value of encrypted will always be `true`. Apigee X and hybrid do not support unencrypted key value maps. + "maskedValues": True or False, # Required. Flag that specifies whether entry values will be masked when returned. "name": "A String", # Required. ID of the key value map. } diff --git a/googleapiclient/discovery_cache/documents/apigee.v1.json b/googleapiclient/discovery_cache/documents/apigee.v1.json index be9e83212c1..90228351d65 100644 --- a/googleapiclient/discovery_cache/documents/apigee.v1.json +++ b/googleapiclient/discovery_cache/documents/apigee.v1.json @@ -2422,7 +2422,7 @@ "type": "string" }, "pageSize": { -"description": "Optional. Count of apps a single page can have in the response. If unspecified, at most 100 apps will be returned. The maximum value is 100; values above 100 will be coerced to 100. \"page_size\" is supported from ver 1.10.0 and above.", +"description": "Optional. Count of apps a single page can have in the response. If unspecified, at most 1000 apps will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. \"page_size\" is supported from ver 1.10.0 and above.", "format": "int32", "location": "query", "type": "integer" @@ -2440,7 +2440,7 @@ "type": "string" }, "rows": { -"description": "Optional. Maximum number of app IDs to return. Defaults to 1000.", +"description": "Optional. Maximum number of app IDs to return. Defaults to 1000, which is also the upper limit. To get more than 1000, use pagination with 'pageSize' and 'pageToken' parameters.", "format": "int64", "location": "query", "type": "string" @@ -11127,7 +11127,7 @@ } } }, -"revision": "20250722", +"revision": "20250731", "rootUrl": "https://apigee.googleapis.com/", "schemas": { "EdgeConfigstoreBundleBadBundle": { @@ -15248,6 +15248,10 @@ "description": "Required. Flag that specifies whether entry values will be encrypted. This field is retained for backward compatibility and the value of encrypted will always be `true`. Apigee X and hybrid do not support unencrypted key value maps.", "type": "boolean" }, +"maskedValues": { +"description": "Required. Flag that specifies whether entry values will be masked when returned.", +"type": "boolean" +}, "name": { "description": "Required. ID of the key value map.", "type": "string" From 87b73d44a6b0d4901b078f2ba88656355f59500d Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:58 +0000 Subject: [PATCH 08/32] feat(backupdr): update the api #### backupdr:v1 The following keys were added: - schemas.DiskBackupProperties.properties.accessMode.type (Total Keys: 1) - schemas.DiskBackupProperties.properties.enableConfidentialCompute.type (Total Keys: 1) - schemas.DiskBackupProperties.properties.labels (Total Keys: 2) - schemas.DiskBackupProperties.properties.physicalBlockSizeBytes (Total Keys: 2) - schemas.DiskBackupProperties.properties.provisionedIops (Total Keys: 2) - schemas.DiskBackupProperties.properties.provisionedThroughput (Total Keys: 2) - schemas.DiskBackupProperties.properties.storagePool.type (Total Keys: 1) - schemas.LocationMetadata (Total Keys: 4) --- ...ions.backupVaults.dataSources.backups.html | 27 +++++++++ .../documents/backupdr.v1.json | 58 ++++++++++++++++++- 2 files changed, 84 insertions(+), 1 deletion(-) diff --git a/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.backups.html b/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.backups.html index c6fe4ce9c0b..aa2591ad3b7 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.backups.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.backups.html @@ -331,22 +331,31 @@

Method Details

"createTime": "A String", # Output only. The time when the instance was created. "description": "A String", # Output only. The description of the Backup instance (2048 characters or less). "diskBackupProperties": { # DiskBackupProperties represents the properties of a Disk backup. # Output only. Disk specific backup properties. + "accessMode": "A String", # The access mode of the source disk. "architecture": "A String", # The architecture of the source disk. Valid values are ARM64 or X86_64. "description": "A String", # A description of the source disk. + "enableConfidentialCompute": True or False, # Indicates whether the source disk is using confidential compute mode. "guestOsFeature": [ # A list of guest OS features that are applicable to this backup. { # Feature type of the Guest OS. "type": "A String", # The ID of a supported feature. }, ], + "labels": { # The labels of the source disk. + "a_key": "A String", + }, "licenses": [ # A list of publicly available licenses that are applicable to this backup. This is applicable if the original image had licenses attached, e.g. Windows image. "A String", ], + "physicalBlockSizeBytes": "A String", # The physical block size of the source disk. + "provisionedIops": "A String", # The number of IOPS provisioned for the source disk. + "provisionedThroughput": "A String", # The number of throughput provisioned for the source disk. "region": "A String", # Region and zone are mutually exclusive fields. The URL of the region of the source disk. "replicaZones": [ # The URL of the Zones where the source disk should be replicated. "A String", ], "sizeGb": "A String", # Size(in GB) of the source disk. "sourceDisk": "A String", # The source disk used to create this backup. + "storagePool": "A String", # The storage pool of the source disk. "type": "A String", # The URL of the type of the disk. "zone": "A String", # The URL of the Zone where the source disk. }, @@ -587,22 +596,31 @@

Method Details

"createTime": "A String", # Output only. The time when the instance was created. "description": "A String", # Output only. The description of the Backup instance (2048 characters or less). "diskBackupProperties": { # DiskBackupProperties represents the properties of a Disk backup. # Output only. Disk specific backup properties. + "accessMode": "A String", # The access mode of the source disk. "architecture": "A String", # The architecture of the source disk. Valid values are ARM64 or X86_64. "description": "A String", # A description of the source disk. + "enableConfidentialCompute": True or False, # Indicates whether the source disk is using confidential compute mode. "guestOsFeature": [ # A list of guest OS features that are applicable to this backup. { # Feature type of the Guest OS. "type": "A String", # The ID of a supported feature. }, ], + "labels": { # The labels of the source disk. + "a_key": "A String", + }, "licenses": [ # A list of publicly available licenses that are applicable to this backup. This is applicable if the original image had licenses attached, e.g. Windows image. "A String", ], + "physicalBlockSizeBytes": "A String", # The physical block size of the source disk. + "provisionedIops": "A String", # The number of IOPS provisioned for the source disk. + "provisionedThroughput": "A String", # The number of throughput provisioned for the source disk. "region": "A String", # Region and zone are mutually exclusive fields. The URL of the region of the source disk. "replicaZones": [ # The URL of the Zones where the source disk should be replicated. "A String", ], "sizeGb": "A String", # Size(in GB) of the source disk. "sourceDisk": "A String", # The source disk used to create this backup. + "storagePool": "A String", # The storage pool of the source disk. "type": "A String", # The URL of the type of the disk. "zone": "A String", # The URL of the Zone where the source disk. }, @@ -847,22 +865,31 @@

Method Details

"createTime": "A String", # Output only. The time when the instance was created. "description": "A String", # Output only. The description of the Backup instance (2048 characters or less). "diskBackupProperties": { # DiskBackupProperties represents the properties of a Disk backup. # Output only. Disk specific backup properties. + "accessMode": "A String", # The access mode of the source disk. "architecture": "A String", # The architecture of the source disk. Valid values are ARM64 or X86_64. "description": "A String", # A description of the source disk. + "enableConfidentialCompute": True or False, # Indicates whether the source disk is using confidential compute mode. "guestOsFeature": [ # A list of guest OS features that are applicable to this backup. { # Feature type of the Guest OS. "type": "A String", # The ID of a supported feature. }, ], + "labels": { # The labels of the source disk. + "a_key": "A String", + }, "licenses": [ # A list of publicly available licenses that are applicable to this backup. This is applicable if the original image had licenses attached, e.g. Windows image. "A String", ], + "physicalBlockSizeBytes": "A String", # The physical block size of the source disk. + "provisionedIops": "A String", # The number of IOPS provisioned for the source disk. + "provisionedThroughput": "A String", # The number of throughput provisioned for the source disk. "region": "A String", # Region and zone are mutually exclusive fields. The URL of the region of the source disk. "replicaZones": [ # The URL of the Zones where the source disk should be replicated. "A String", ], "sizeGb": "A String", # Size(in GB) of the source disk. "sourceDisk": "A String", # The source disk used to create this backup. + "storagePool": "A String", # The storage pool of the source disk. "type": "A String", # The URL of the type of the disk. "zone": "A String", # The URL of the Zone where the source disk. }, diff --git a/googleapiclient/discovery_cache/documents/backupdr.v1.json b/googleapiclient/discovery_cache/documents/backupdr.v1.json index 1ef802139e2..cc60b03ecf2 100644 --- a/googleapiclient/discovery_cache/documents/backupdr.v1.json +++ b/googleapiclient/discovery_cache/documents/backupdr.v1.json @@ -2060,7 +2060,7 @@ } } }, -"revision": "20250723", +"revision": "20250730", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -4029,6 +4029,10 @@ "description": "DiskBackupProperties represents the properties of a Disk backup.", "id": "DiskBackupProperties", "properties": { +"accessMode": { +"description": "The access mode of the source disk.", +"type": "string" +}, "architecture": { "description": "The architecture of the source disk. Valid values are ARM64 or X86_64.", "enum": [ @@ -4047,6 +4051,10 @@ "description": "A description of the source disk.", "type": "string" }, +"enableConfidentialCompute": { +"description": "Indicates whether the source disk is using confidential compute mode.", +"type": "boolean" +}, "guestOsFeature": { "description": "A list of guest OS features that are applicable to this backup.", "items": { @@ -4054,6 +4062,13 @@ }, "type": "array" }, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "The labels of the source disk.", +"type": "object" +}, "licenses": { "description": "A list of publicly available licenses that are applicable to this backup. This is applicable if the original image had licenses attached, e.g. Windows image.", "items": { @@ -4061,6 +4076,21 @@ }, "type": "array" }, +"physicalBlockSizeBytes": { +"description": "The physical block size of the source disk.", +"format": "int64", +"type": "string" +}, +"provisionedIops": { +"description": "The number of IOPS provisioned for the source disk.", +"format": "int64", +"type": "string" +}, +"provisionedThroughput": { +"description": "The number of throughput provisioned for the source disk.", +"format": "int64", +"type": "string" +}, "region": { "description": "Region and zone are mutually exclusive fields. The URL of the region of the source disk.", "type": "string" @@ -4081,6 +4111,10 @@ "description": "The source disk used to create this backup.", "type": "string" }, +"storagePool": { +"description": "The storage pool of the source disk.", +"type": "string" +}, "type": { "description": "The URL of the type of the disk.", "type": "string" @@ -4931,6 +4965,28 @@ }, "type": "object" }, +"LocationMetadata": { +"id": "LocationMetadata", +"properties": { +"unsupportedFeatures": { +"items": { +"enum": [ +"FEATURE_UNSPECIFIED", +"MANAGEMENT_SERVER", +"COMPUTE_INSTANCE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, "ManagementServer": { "description": "ManagementServer describes a single BackupDR ManagementServer instance.", "id": "ManagementServer", From 9965bad8b0d7f7cfce35cb4e9ae336c08b399b20 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:58 +0000 Subject: [PATCH 09/32] feat(bigtableadmin): update the api #### bigtableadmin:v2 The following keys were added: - schemas.Instance.properties.tags (Total Keys: 2) --- .../bigtableadmin_v2.projects.instances.html | 18 ++++++++++++++++++ .../documents/bigtableadmin.v2.json | 9 ++++++++- 2 files changed, 26 insertions(+), 1 deletion(-) diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.html b/docs/dyn/bigtableadmin_v2.projects.instances.html index cca4e560b9c..9df57260cd2 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.html @@ -183,6 +183,9 @@

Method Details

"satisfiesPzi": True or False, # Output only. Reserved for future use. "satisfiesPzs": True or False, # Output only. Reserved for future use. "state": "A String", # Output only. The current state of the instance. + "tags": { # Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" Tags and Labels (above) are both used to bind metadata to resources, with different use-cases. See https://cloud.google.com/resource-manager/docs/tags/tags-overview for an in-depth overview on the difference between tags and labels. + "a_key": "A String", + }, "type": "A String", # The type of the instance. Defaults to `PRODUCTION`. }, "instanceId": "A String", # Required. The ID to be used when referring to the new instance within its project, e.g., just `myinstance` rather than `projects/myproject/instances/myinstance`. @@ -260,6 +263,9 @@

Method Details

"satisfiesPzi": True or False, # Output only. Reserved for future use. "satisfiesPzs": True or False, # Output only. Reserved for future use. "state": "A String", # Output only. The current state of the instance. + "tags": { # Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" Tags and Labels (above) are both used to bind metadata to resources, with different use-cases. See https://cloud.google.com/resource-manager/docs/tags/tags-overview for an in-depth overview on the difference between tags and labels. + "a_key": "A String", + }, "type": "A String", # The type of the instance. Defaults to `PRODUCTION`. } @@ -350,6 +356,9 @@

Method Details

"satisfiesPzi": True or False, # Output only. Reserved for future use. "satisfiesPzs": True or False, # Output only. Reserved for future use. "state": "A String", # Output only. The current state of the instance. + "tags": { # Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" Tags and Labels (above) are both used to bind metadata to resources, with different use-cases. See https://cloud.google.com/resource-manager/docs/tags/tags-overview for an in-depth overview on the difference between tags and labels. + "a_key": "A String", + }, "type": "A String", # The type of the instance. Defaults to `PRODUCTION`. }, ], @@ -390,6 +399,9 @@

Method Details

"satisfiesPzi": True or False, # Output only. Reserved for future use. "satisfiesPzs": True or False, # Output only. Reserved for future use. "state": "A String", # Output only. The current state of the instance. + "tags": { # Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" Tags and Labels (above) are both used to bind metadata to resources, with different use-cases. See https://cloud.google.com/resource-manager/docs/tags/tags-overview for an in-depth overview on the difference between tags and labels. + "a_key": "A String", + }, "type": "A String", # The type of the instance. Defaults to `PRODUCTION`. } @@ -557,6 +569,9 @@

Method Details

"satisfiesPzi": True or False, # Output only. Reserved for future use. "satisfiesPzs": True or False, # Output only. Reserved for future use. "state": "A String", # Output only. The current state of the instance. + "tags": { # Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" Tags and Labels (above) are both used to bind metadata to resources, with different use-cases. See https://cloud.google.com/resource-manager/docs/tags/tags-overview for an in-depth overview on the difference between tags and labels. + "a_key": "A String", + }, "type": "A String", # The type of the instance. Defaults to `PRODUCTION`. } @@ -578,6 +593,9 @@

Method Details

"satisfiesPzi": True or False, # Output only. Reserved for future use. "satisfiesPzs": True or False, # Output only. Reserved for future use. "state": "A String", # Output only. The current state of the instance. + "tags": { # Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" Tags and Labels (above) are both used to bind metadata to resources, with different use-cases. See https://cloud.google.com/resource-manager/docs/tags/tags-overview for an in-depth overview on the difference between tags and labels. + "a_key": "A String", + }, "type": "A String", # The type of the instance. Defaults to `PRODUCTION`. } diff --git a/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json b/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json index 164116f5a8f..633b29da4df 100644 --- a/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json +++ b/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json @@ -3168,7 +3168,7 @@ } } }, -"revision": "20250724", +"revision": "20250804", "rootUrl": "https://bigtableadmin.googleapis.com/", "schemas": { "AppProfile": { @@ -4695,6 +4695,13 @@ "readOnly": true, "type": "string" }, +"tags": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\" Tags and Labels (above) are both used to bind metadata to resources, with different use-cases. See https://cloud.google.com/resource-manager/docs/tags/tags-overview for an in-depth overview on the difference between tags and labels.", +"type": "object" +}, "type": { "description": "The type of the instance. Defaults to `PRODUCTION`.", "enum": [ From 9b6ae1d596d4388676f8bee0004b91c9ed4ce432 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:58 +0000 Subject: [PATCH 10/32] feat(cloudbuild): update the api #### cloudbuild:v1 The following keys were added: - schemas.WorkerConfig.properties.enableNestedVirtualization.type (Total Keys: 1) --- docs/dyn/cloudbuild_v1.projects.locations.workerPools.html | 4 ++++ .../discovery_cache/documents/cloudbuild.v1.json | 6 +++++- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html b/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html index 91a29d11bc4..20aba413481 100644 --- a/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html +++ b/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html @@ -132,6 +132,7 @@

Method Details

}, "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. + "enableNestedVirtualization": True or False, # Optional. Enable nested virtualization on the worker, if supported by the machine type. By default, nested virtualization is disabled. "machineType": "A String", # Optional. Machine type of a worker, such as `e2-medium`. See [Worker pool config file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema). If left blank, Cloud Build will use a sensible default. }, }, @@ -245,6 +246,7 @@

Method Details

}, "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. + "enableNestedVirtualization": True or False, # Optional. Enable nested virtualization on the worker, if supported by the machine type. By default, nested virtualization is disabled. "machineType": "A String", # Optional. Machine type of a worker, such as `e2-medium`. See [Worker pool config file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema). If left blank, Cloud Build will use a sensible default. }, }, @@ -295,6 +297,7 @@

Method Details

}, "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. + "enableNestedVirtualization": True or False, # Optional. Enable nested virtualization on the worker, if supported by the machine type. By default, nested virtualization is disabled. "machineType": "A String", # Optional. Machine type of a worker, such as `e2-medium`. See [Worker pool config file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema). If left blank, Cloud Build will use a sensible default. }, }, @@ -351,6 +354,7 @@

Method Details

}, "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. + "enableNestedVirtualization": True or False, # Optional. Enable nested virtualization on the worker, if supported by the machine type. By default, nested virtualization is disabled. "machineType": "A String", # Optional. Machine type of a worker, such as `e2-medium`. See [Worker pool config file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema). If left blank, Cloud Build will use a sensible default. }, }, diff --git a/googleapiclient/discovery_cache/documents/cloudbuild.v1.json b/googleapiclient/discovery_cache/documents/cloudbuild.v1.json index 6bf7afb3305..52a313a7296 100644 --- a/googleapiclient/discovery_cache/documents/cloudbuild.v1.json +++ b/googleapiclient/discovery_cache/documents/cloudbuild.v1.json @@ -2573,7 +2573,7 @@ } } }, -"revision": "20250718", +"revision": "20250801", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "ApprovalConfig": { @@ -5864,6 +5864,10 @@ false "format": "int64", "type": "string" }, +"enableNestedVirtualization": { +"description": "Optional. Enable nested virtualization on the worker, if supported by the machine type. By default, nested virtualization is disabled.", +"type": "boolean" +}, "machineType": { "description": "Optional. Machine type of a worker, such as `e2-medium`. See [Worker pool config file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema). If left blank, Cloud Build will use a sensible default.", "type": "string" From 2bd9d9a1baa64474582576f9994842a5b96f16c9 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:58 +0000 Subject: [PATCH 11/32] feat(cloudidentity): update the api #### cloudidentity:v1 The following keys were added: - resources.inboundOidcSsoProfiles.methods.create (Total Keys: 8) - resources.inboundOidcSsoProfiles.methods.delete (Total Keys: 11) - resources.inboundOidcSsoProfiles.methods.get (Total Keys: 11) - resources.inboundOidcSsoProfiles.methods.list (Total Keys: 14) - resources.inboundOidcSsoProfiles.methods.patch (Total Keys: 15) - schemas.CreateInboundOidcSsoProfileOperationMetadata (Total Keys: 3) - schemas.DeleteInboundOidcSsoProfileOperationMetadata (Total Keys: 2) - schemas.InboundOidcSsoProfile (Total Keys: 8) - schemas.InboundSsoAssignment.properties.oidcSsoInfo.$ref (Total Keys: 1) - schemas.ListInboundOidcSsoProfilesResponse (Total Keys: 5) - schemas.OidcIdpConfig (Total Keys: 4) - schemas.OidcRpConfig (Total Keys: 7) - schemas.OidcSsoInfo (Total Keys: 3) - schemas.UpdateInboundOidcSsoProfileOperationMetadata (Total Keys: 3) #### cloudidentity:v1beta1 The following keys were added: - resources.inboundOidcSsoProfiles.methods.create (Total Keys: 8) - resources.inboundOidcSsoProfiles.methods.delete (Total Keys: 11) - resources.inboundOidcSsoProfiles.methods.get (Total Keys: 11) - resources.inboundOidcSsoProfiles.methods.list (Total Keys: 14) - resources.inboundOidcSsoProfiles.methods.patch (Total Keys: 15) - schemas.CreateInboundOidcSsoProfileOperationMetadata (Total Keys: 3) - schemas.DeleteInboundOidcSsoProfileOperationMetadata (Total Keys: 2) - schemas.InboundOidcSsoProfile (Total Keys: 8) - schemas.InboundSsoAssignment.properties.oidcSsoInfo.$ref (Total Keys: 1) - schemas.ListInboundOidcSsoProfilesResponse (Total Keys: 5) - schemas.OidcIdpConfig (Total Keys: 4) - schemas.OidcRpConfig (Total Keys: 7) - schemas.OidcSsoInfo (Total Keys: 3) - schemas.UpdateInboundOidcSsoProfileOperationMetadata (Total Keys: 3) --- docs/dyn/cloudidentity_v1.html | 5 + ...oudidentity_v1.inboundOidcSsoProfiles.html | 334 ++++++++++++++++++ ...loudidentity_v1.inboundSsoAssignments.html | 12 + docs/dyn/cloudidentity_v1beta1.html | 5 + ...entity_v1beta1.inboundOidcSsoProfiles.html | 334 ++++++++++++++++++ ...dentity_v1beta1.inboundSsoAssignments.html | 12 + .../documents/cloudidentity.v1.json | 276 ++++++++++++++- .../documents/cloudidentity.v1beta1.json | 276 ++++++++++++++- 8 files changed, 1252 insertions(+), 2 deletions(-) create mode 100644 docs/dyn/cloudidentity_v1.inboundOidcSsoProfiles.html create mode 100644 docs/dyn/cloudidentity_v1beta1.inboundOidcSsoProfiles.html diff --git a/docs/dyn/cloudidentity_v1.html b/docs/dyn/cloudidentity_v1.html index c19e9525f54..621b9236e40 100644 --- a/docs/dyn/cloudidentity_v1.html +++ b/docs/dyn/cloudidentity_v1.html @@ -89,6 +89,11 @@

Instance Methods

Returns the groups Resource.

+

+ inboundOidcSsoProfiles() +

+

Returns the inboundOidcSsoProfiles Resource.

+

inboundSamlSsoProfiles()

diff --git a/docs/dyn/cloudidentity_v1.inboundOidcSsoProfiles.html b/docs/dyn/cloudidentity_v1.inboundOidcSsoProfiles.html new file mode 100644 index 00000000000..89889e8bd1b --- /dev/null +++ b/docs/dyn/cloudidentity_v1.inboundOidcSsoProfiles.html @@ -0,0 +1,334 @@ + + + +

Cloud Identity API . inboundOidcSsoProfiles

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ create(body=None, x__xgafv=None)

+

Creates an InboundOidcSsoProfile for a customer. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.

+

+ delete(name, x__xgafv=None)

+

Deletes an InboundOidcSsoProfile.

+

+ get(name, x__xgafv=None)

+

Gets an InboundOidcSsoProfile.

+

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

+

Lists InboundOidcSsoProfile objects for a Google enterprise customer.

+

+ list_next()

+

Retrieves the next page of results.

+

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

+

Updates an InboundOidcSsoProfile. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ create(body=None, x__xgafv=None) + 
Creates an InboundOidcSsoProfile for a customer. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.
+
+Args:
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An [OIDC](https://openid.net/developers/how-connect-works/) federation between a Google enterprise customer and an OIDC identity provider.
+  "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`.
+  "displayName": "A String", # Human-readable name of the OIDC SSO profile.
+  "idpConfig": { # OIDC IDP (identity provider) configuration. # OIDC identity provider configuration.
+    "changePasswordUri": "A String", # The **Change Password URL** of the identity provider. Users will be sent to this URL when changing their passwords at `myaccount.google.com`. This takes precedence over the change password URL configured at customer-level. Must use `HTTPS`.
+    "issuerUri": "A String", # Required. The Issuer identifier for the IdP. Must be a URL. The discovery URL will be derived from this as described in Section 4 of [the OIDC specification](https://openid.net/specs/openid-connect-discovery-1_0.html).
+  },
+  "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.
+  "rpConfig": { # OIDC RP (relying party) configuration. # OIDC relying party (RP) configuration for this OIDC SSO profile. These are the RP details provided by Google that should be configured on the corresponding identity provider.
+    "clientId": "A String", # OAuth2 client ID for OIDC.
+    "clientSecret": "A String", # Input only. OAuth2 client secret for OIDC.
+    "redirectUris": [ # Output only. The URL(s) that this client may use in authentication requests.
+      "A String",
+    ],
+  },
+}
+
+  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.
+  },
+}
+
+ +
+ delete(name, x__xgafv=None) + 
Deletes an InboundOidcSsoProfile.
+
+Args:
+  name: string, Required. The [resource name](https://cloud.google.com/apis/design/resource_names) of the InboundOidcSsoProfile to delete. Format: `inboundOidcSsoProfiles/{sso_profile_id}` (required)
+  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.
+  },
+}
+
+ +
+ get(name, x__xgafv=None) + 
Gets an InboundOidcSsoProfile.
+
+Args:
+  name: string, Required. The [resource name](https://cloud.google.com/apis/design/resource_names) of the InboundOidcSsoProfile to get. Format: `inboundOidcSsoProfiles/{sso_profile_id}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An [OIDC](https://openid.net/developers/how-connect-works/) federation between a Google enterprise customer and an OIDC identity provider.
+  "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`.
+  "displayName": "A String", # Human-readable name of the OIDC SSO profile.
+  "idpConfig": { # OIDC IDP (identity provider) configuration. # OIDC identity provider configuration.
+    "changePasswordUri": "A String", # The **Change Password URL** of the identity provider. Users will be sent to this URL when changing their passwords at `myaccount.google.com`. This takes precedence over the change password URL configured at customer-level. Must use `HTTPS`.
+    "issuerUri": "A String", # Required. The Issuer identifier for the IdP. Must be a URL. The discovery URL will be derived from this as described in Section 4 of [the OIDC specification](https://openid.net/specs/openid-connect-discovery-1_0.html).
+  },
+  "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.
+  "rpConfig": { # OIDC RP (relying party) configuration. # OIDC relying party (RP) configuration for this OIDC SSO profile. These are the RP details provided by Google that should be configured on the corresponding identity provider.
+    "clientId": "A String", # OAuth2 client ID for OIDC.
+    "clientSecret": "A String", # Input only. OAuth2 client secret for OIDC.
+    "redirectUris": [ # Output only. The URL(s) that this client may use in authentication requests.
+      "A String",
+    ],
+  },
+}
+
+ +
+ list(filter=None, pageSize=None, pageToken=None, x__xgafv=None) + 
Lists InboundOidcSsoProfile objects for a Google enterprise customer.
+
+Args:
+  filter: string, A [Common Expression Language](https://github.com/google/cel-spec) expression to filter the results. The only supported filter is filtering by customer. For example: `customer=="customers/C0123abc"`. Omitting the filter or specifying a filter of `customer=="customers/my_customer"` will return the profiles for the customer that the caller (authenticated user) belongs to. Specifying a filter of `customer==""` will return the global shared OIDC profiles.
+  pageSize: integer, The maximum number of InboundOidcSsoProfiles to return. The service may return fewer than this value. If omitted (or defaulted to zero) the server will use a sensible default. This default may change over time. The maximum allowed value is 100. Requests with page_size greater than that will be silently interpreted as having this maximum value.
+  pageToken: string, A page token, received from a previous `ListInboundOidcSsoProfiles` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListInboundOidcSsoProfiles` 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 of the InboundOidcSsoProfilesService.ListInboundOidcSsoProfiles method.
+  "inboundOidcSsoProfiles": [ # List of InboundOidcSsoProfiles.
+    { # An [OIDC](https://openid.net/developers/how-connect-works/) federation between a Google enterprise customer and an OIDC identity provider.
+      "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`.
+      "displayName": "A String", # Human-readable name of the OIDC SSO profile.
+      "idpConfig": { # OIDC IDP (identity provider) configuration. # OIDC identity provider configuration.
+        "changePasswordUri": "A String", # The **Change Password URL** of the identity provider. Users will be sent to this URL when changing their passwords at `myaccount.google.com`. This takes precedence over the change password URL configured at customer-level. Must use `HTTPS`.
+        "issuerUri": "A String", # Required. The Issuer identifier for the IdP. Must be a URL. The discovery URL will be derived from this as described in Section 4 of [the OIDC specification](https://openid.net/specs/openid-connect-discovery-1_0.html).
+      },
+      "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.
+      "rpConfig": { # OIDC RP (relying party) configuration. # OIDC relying party (RP) configuration for this OIDC SSO profile. These are the RP details provided by Google that should be configured on the corresponding identity provider.
+        "clientId": "A String", # OAuth2 client ID for OIDC.
+        "clientSecret": "A String", # Input only. OAuth2 client secret for OIDC.
+        "redirectUris": [ # Output only. The URL(s) that this client may use in authentication requests.
+          "A String",
+        ],
+      },
+    },
+  ],
+  "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.
+}
+
+ +
+ 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 InboundOidcSsoProfile. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.
+
+Args:
+  name: string, Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An [OIDC](https://openid.net/developers/how-connect-works/) federation between a Google enterprise customer and an OIDC identity provider.
+  "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`.
+  "displayName": "A String", # Human-readable name of the OIDC SSO profile.
+  "idpConfig": { # OIDC IDP (identity provider) configuration. # OIDC identity provider configuration.
+    "changePasswordUri": "A String", # The **Change Password URL** of the identity provider. Users will be sent to this URL when changing their passwords at `myaccount.google.com`. This takes precedence over the change password URL configured at customer-level. Must use `HTTPS`.
+    "issuerUri": "A String", # Required. The Issuer identifier for the IdP. Must be a URL. The discovery URL will be derived from this as described in Section 4 of [the OIDC specification](https://openid.net/specs/openid-connect-discovery-1_0.html).
+  },
+  "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.
+  "rpConfig": { # OIDC RP (relying party) configuration. # OIDC relying party (RP) configuration for this OIDC SSO profile. These are the RP details provided by Google that should be configured on the corresponding identity provider.
+    "clientId": "A String", # OAuth2 client ID for OIDC.
+    "clientSecret": "A String", # Input only. OAuth2 client secret for OIDC.
+    "redirectUris": [ # Output only. The URL(s) that this client may use in authentication requests.
+      "A String",
+    ],
+  },
+}
+
+  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:
+
+    { # 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.
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/cloudidentity_v1.inboundSsoAssignments.html b/docs/dyn/cloudidentity_v1.inboundSsoAssignments.html index 6346a65e43a..f3d89e669f6 100644 --- a/docs/dyn/cloudidentity_v1.inboundSsoAssignments.html +++ b/docs/dyn/cloudidentity_v1.inboundSsoAssignments.html @@ -112,6 +112,9 @@

Method Details

{ # Targets with "set" SSO assignments and their respective assignments. "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`. "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the Inbound SSO Assignment. + "oidcSsoInfo": { # Details that are applicable when `sso_mode` is set to `OIDC_SSO`. # OpenID Connect SSO details. Must be set if and only if `sso_mode` is set to `OIDC_SSO`. + "inboundOidcSsoProfile": "A String", # Required. Name of the `InboundOidcSsoProfile` to use. Must be of the form `inboundOidcSsoProfiles/{inbound_oidc_sso_profile}`. + }, "rank": 42, # Must be zero (which is the default value so it can be omitted) for assignments with `target_org_unit` set and must be greater-than-or-equal-to one for assignments with `target_group` set. "samlSsoInfo": { # Details that are applicable when `sso_mode` == `SAML_SSO`. # SAML SSO details. Must be set if and only if `sso_mode` is set to `SAML_SSO`. "inboundSamlSsoProfile": "A String", # Required. Name of the `InboundSamlSsoProfile` to use. Must be of the form `inboundSamlSsoProfiles/{inbound_saml_sso_profile}`. @@ -205,6 +208,9 @@

Method Details

{ # Targets with "set" SSO assignments and their respective assignments. "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`. "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the Inbound SSO Assignment. + "oidcSsoInfo": { # Details that are applicable when `sso_mode` is set to `OIDC_SSO`. # OpenID Connect SSO details. Must be set if and only if `sso_mode` is set to `OIDC_SSO`. + "inboundOidcSsoProfile": "A String", # Required. Name of the `InboundOidcSsoProfile` to use. Must be of the form `inboundOidcSsoProfiles/{inbound_oidc_sso_profile}`. + }, "rank": 42, # Must be zero (which is the default value so it can be omitted) for assignments with `target_org_unit` set and must be greater-than-or-equal-to one for assignments with `target_group` set. "samlSsoInfo": { # Details that are applicable when `sso_mode` == `SAML_SSO`. # SAML SSO details. Must be set if and only if `sso_mode` is set to `SAML_SSO`. "inboundSamlSsoProfile": "A String", # Required. Name of the `InboundSamlSsoProfile` to use. Must be of the form `inboundSamlSsoProfiles/{inbound_saml_sso_profile}`. @@ -239,6 +245,9 @@

Method Details

{ # Targets with "set" SSO assignments and their respective assignments. "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`. "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the Inbound SSO Assignment. + "oidcSsoInfo": { # Details that are applicable when `sso_mode` is set to `OIDC_SSO`. # OpenID Connect SSO details. Must be set if and only if `sso_mode` is set to `OIDC_SSO`. + "inboundOidcSsoProfile": "A String", # Required. Name of the `InboundOidcSsoProfile` to use. Must be of the form `inboundOidcSsoProfiles/{inbound_oidc_sso_profile}`. + }, "rank": 42, # Must be zero (which is the default value so it can be omitted) for assignments with `target_org_unit` set and must be greater-than-or-equal-to one for assignments with `target_group` set. "samlSsoInfo": { # Details that are applicable when `sso_mode` == `SAML_SSO`. # SAML SSO details. Must be set if and only if `sso_mode` is set to `SAML_SSO`. "inboundSamlSsoProfile": "A String", # Required. Name of the `InboundSamlSsoProfile` to use. Must be of the form `inboundSamlSsoProfiles/{inbound_saml_sso_profile}`. @@ -281,6 +290,9 @@

Method Details

{ # Targets with "set" SSO assignments and their respective assignments. "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`. "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the Inbound SSO Assignment. + "oidcSsoInfo": { # Details that are applicable when `sso_mode` is set to `OIDC_SSO`. # OpenID Connect SSO details. Must be set if and only if `sso_mode` is set to `OIDC_SSO`. + "inboundOidcSsoProfile": "A String", # Required. Name of the `InboundOidcSsoProfile` to use. Must be of the form `inboundOidcSsoProfiles/{inbound_oidc_sso_profile}`. + }, "rank": 42, # Must be zero (which is the default value so it can be omitted) for assignments with `target_org_unit` set and must be greater-than-or-equal-to one for assignments with `target_group` set. "samlSsoInfo": { # Details that are applicable when `sso_mode` == `SAML_SSO`. # SAML SSO details. Must be set if and only if `sso_mode` is set to `SAML_SSO`. "inboundSamlSsoProfile": "A String", # Required. Name of the `InboundSamlSsoProfile` to use. Must be of the form `inboundSamlSsoProfiles/{inbound_saml_sso_profile}`. diff --git a/docs/dyn/cloudidentity_v1beta1.html b/docs/dyn/cloudidentity_v1beta1.html index 92d1607583d..854ad21af08 100644 --- a/docs/dyn/cloudidentity_v1beta1.html +++ b/docs/dyn/cloudidentity_v1beta1.html @@ -89,6 +89,11 @@

Instance Methods

Returns the groups Resource.

+

+ inboundOidcSsoProfiles() +

+

Returns the inboundOidcSsoProfiles Resource.

+

inboundSamlSsoProfiles()

diff --git a/docs/dyn/cloudidentity_v1beta1.inboundOidcSsoProfiles.html b/docs/dyn/cloudidentity_v1beta1.inboundOidcSsoProfiles.html new file mode 100644 index 00000000000..f6543194f89 --- /dev/null +++ b/docs/dyn/cloudidentity_v1beta1.inboundOidcSsoProfiles.html @@ -0,0 +1,334 @@ + + + +

Cloud Identity API . inboundOidcSsoProfiles

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ create(body=None, x__xgafv=None)

+

Creates an InboundOidcSsoProfile for a customer. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.

+

+ delete(name, x__xgafv=None)

+

Deletes an InboundOidcSsoProfile.

+

+ get(name, x__xgafv=None)

+

Gets an InboundOidcSsoProfile.

+

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

+

Lists InboundOidcSsoProfile objects for a Google enterprise customer.

+

+ list_next()

+

Retrieves the next page of results.

+

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

+

Updates an InboundOidcSsoProfile. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ create(body=None, x__xgafv=None) + 
Creates an InboundOidcSsoProfile for a customer. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.
+
+Args:
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An [OIDC](https://openid.net/developers/how-connect-works/) federation between a Google enterprise customer and an OIDC identity provider.
+  "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`.
+  "displayName": "A String", # Human-readable name of the OIDC SSO profile.
+  "idpConfig": { # OIDC IDP (identity provider) configuration. # OIDC identity provider configuration.
+    "changePasswordUri": "A String", # The **Change Password URL** of the identity provider. Users will be sent to this URL when changing their passwords at `myaccount.google.com`. This takes precedence over the change password URL configured at customer-level. Must use `HTTPS`.
+    "issuerUri": "A String", # Required. The Issuer identifier for the IdP. Must be a URL. The discovery URL will be derived from this as described in Section 4 of [the OIDC specification](https://openid.net/specs/openid-connect-discovery-1_0.html).
+  },
+  "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.
+  "rpConfig": { # OIDC RP (relying party) configuration. # OIDC relying party (RP) configuration for this OIDC SSO profile. These are the RP details provided by Google that should be configured on the corresponding identity provider.
+    "clientId": "A String", # OAuth2 client ID for OIDC.
+    "clientSecret": "A String", # Input only. OAuth2 client secret for OIDC.
+    "redirectUris": [ # Output only. The URL(s) that this client may use in authentication requests.
+      "A String",
+    ],
+  },
+}
+
+  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.
+  },
+}
+
+ +
+ delete(name, x__xgafv=None) + 
Deletes an InboundOidcSsoProfile.
+
+Args:
+  name: string, Required. The [resource name](https://cloud.google.com/apis/design/resource_names) of the InboundOidcSsoProfile to delete. Format: `inboundOidcSsoProfiles/{sso_profile_id}` (required)
+  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.
+  },
+}
+
+ +
+ get(name, x__xgafv=None) + 
Gets an InboundOidcSsoProfile.
+
+Args:
+  name: string, Required. The [resource name](https://cloud.google.com/apis/design/resource_names) of the InboundOidcSsoProfile to get. Format: `inboundOidcSsoProfiles/{sso_profile_id}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An [OIDC](https://openid.net/developers/how-connect-works/) federation between a Google enterprise customer and an OIDC identity provider.
+  "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`.
+  "displayName": "A String", # Human-readable name of the OIDC SSO profile.
+  "idpConfig": { # OIDC IDP (identity provider) configuration. # OIDC identity provider configuration.
+    "changePasswordUri": "A String", # The **Change Password URL** of the identity provider. Users will be sent to this URL when changing their passwords at `myaccount.google.com`. This takes precedence over the change password URL configured at customer-level. Must use `HTTPS`.
+    "issuerUri": "A String", # Required. The Issuer identifier for the IdP. Must be a URL. The discovery URL will be derived from this as described in Section 4 of [the OIDC specification](https://openid.net/specs/openid-connect-discovery-1_0.html).
+  },
+  "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.
+  "rpConfig": { # OIDC RP (relying party) configuration. # OIDC relying party (RP) configuration for this OIDC SSO profile. These are the RP details provided by Google that should be configured on the corresponding identity provider.
+    "clientId": "A String", # OAuth2 client ID for OIDC.
+    "clientSecret": "A String", # Input only. OAuth2 client secret for OIDC.
+    "redirectUris": [ # Output only. The URL(s) that this client may use in authentication requests.
+      "A String",
+    ],
+  },
+}
+
+ +
+ list(filter=None, pageSize=None, pageToken=None, x__xgafv=None) + 
Lists InboundOidcSsoProfile objects for a Google enterprise customer.
+
+Args:
+  filter: string, A [Common Expression Language](https://github.com/google/cel-spec) expression to filter the results. The only supported filter is filtering by customer. For example: `customer=="customers/C0123abc"`. Omitting the filter or specifying a filter of `customer=="customers/my_customer"` will return the profiles for the customer that the caller (authenticated user) belongs to. Specifying a filter of `customer==""` will return the global shared OIDC profiles.
+  pageSize: integer, The maximum number of InboundOidcSsoProfiles to return. The service may return fewer than this value. If omitted (or defaulted to zero) the server will use a sensible default. This default may change over time. The maximum allowed value is 100. Requests with page_size greater than that will be silently interpreted as having this maximum value.
+  pageToken: string, A page token, received from a previous `ListInboundOidcSsoProfiles` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListInboundOidcSsoProfiles` 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 of the InboundOidcSsoProfilesService.ListInboundOidcSsoProfiles method.
+  "inboundOidcSsoProfiles": [ # List of InboundOidcSsoProfiles.
+    { # An [OIDC](https://openid.net/developers/how-connect-works/) federation between a Google enterprise customer and an OIDC identity provider.
+      "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`.
+      "displayName": "A String", # Human-readable name of the OIDC SSO profile.
+      "idpConfig": { # OIDC IDP (identity provider) configuration. # OIDC identity provider configuration.
+        "changePasswordUri": "A String", # The **Change Password URL** of the identity provider. Users will be sent to this URL when changing their passwords at `myaccount.google.com`. This takes precedence over the change password URL configured at customer-level. Must use `HTTPS`.
+        "issuerUri": "A String", # Required. The Issuer identifier for the IdP. Must be a URL. The discovery URL will be derived from this as described in Section 4 of [the OIDC specification](https://openid.net/specs/openid-connect-discovery-1_0.html).
+      },
+      "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.
+      "rpConfig": { # OIDC RP (relying party) configuration. # OIDC relying party (RP) configuration for this OIDC SSO profile. These are the RP details provided by Google that should be configured on the corresponding identity provider.
+        "clientId": "A String", # OAuth2 client ID for OIDC.
+        "clientSecret": "A String", # Input only. OAuth2 client secret for OIDC.
+        "redirectUris": [ # Output only. The URL(s) that this client may use in authentication requests.
+          "A String",
+        ],
+      },
+    },
+  ],
+  "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.
+}
+
+ +
+ 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 InboundOidcSsoProfile. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.
+
+Args:
+  name: string, Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An [OIDC](https://openid.net/developers/how-connect-works/) federation between a Google enterprise customer and an OIDC identity provider.
+  "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`.
+  "displayName": "A String", # Human-readable name of the OIDC SSO profile.
+  "idpConfig": { # OIDC IDP (identity provider) configuration. # OIDC identity provider configuration.
+    "changePasswordUri": "A String", # The **Change Password URL** of the identity provider. Users will be sent to this URL when changing their passwords at `myaccount.google.com`. This takes precedence over the change password URL configured at customer-level. Must use `HTTPS`.
+    "issuerUri": "A String", # Required. The Issuer identifier for the IdP. Must be a URL. The discovery URL will be derived from this as described in Section 4 of [the OIDC specification](https://openid.net/specs/openid-connect-discovery-1_0.html).
+  },
+  "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.
+  "rpConfig": { # OIDC RP (relying party) configuration. # OIDC relying party (RP) configuration for this OIDC SSO profile. These are the RP details provided by Google that should be configured on the corresponding identity provider.
+    "clientId": "A String", # OAuth2 client ID for OIDC.
+    "clientSecret": "A String", # Input only. OAuth2 client secret for OIDC.
+    "redirectUris": [ # Output only. The URL(s) that this client may use in authentication requests.
+      "A String",
+    ],
+  },
+}
+
+  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:
+
+    { # 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.
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/cloudidentity_v1beta1.inboundSsoAssignments.html b/docs/dyn/cloudidentity_v1beta1.inboundSsoAssignments.html index 15bb3967233..c13d81a7768 100644 --- a/docs/dyn/cloudidentity_v1beta1.inboundSsoAssignments.html +++ b/docs/dyn/cloudidentity_v1beta1.inboundSsoAssignments.html @@ -112,6 +112,9 @@

Method Details

{ # Targets with "set" SSO assignments and their respective assignments. "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`. "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the Inbound SSO Assignment. + "oidcSsoInfo": { # Details that are applicable when `sso_mode` is set to `OIDC_SSO`. # OpenID Connect SSO details. Must be set if and only if `sso_mode` is set to `OIDC_SSO`. + "inboundOidcSsoProfile": "A String", # Required. Name of the `InboundOidcSsoProfile` to use. Must be of the form `inboundOidcSsoProfiles/{inbound_oidc_sso_profile}`. + }, "rank": 42, # Must be zero (which is the default value so it can be omitted) for assignments with `target_org_unit` set and must be greater-than-or-equal-to one for assignments with `target_group` set. "samlSsoInfo": { # Details that are applicable when `sso_mode` == `SAML_SSO`. # SAML SSO details. Must be set if and only if `sso_mode` is set to `SAML_SSO`. "inboundSamlSsoProfile": "A String", # Required. Name of the `InboundSamlSsoProfile` to use. Must be of the form `inboundSamlSsoProfiles/{inbound_saml_sso_profile}`. @@ -205,6 +208,9 @@

Method Details

{ # Targets with "set" SSO assignments and their respective assignments. "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`. "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the Inbound SSO Assignment. + "oidcSsoInfo": { # Details that are applicable when `sso_mode` is set to `OIDC_SSO`. # OpenID Connect SSO details. Must be set if and only if `sso_mode` is set to `OIDC_SSO`. + "inboundOidcSsoProfile": "A String", # Required. Name of the `InboundOidcSsoProfile` to use. Must be of the form `inboundOidcSsoProfiles/{inbound_oidc_sso_profile}`. + }, "rank": 42, # Must be zero (which is the default value so it can be omitted) for assignments with `target_org_unit` set and must be greater-than-or-equal-to one for assignments with `target_group` set. "samlSsoInfo": { # Details that are applicable when `sso_mode` == `SAML_SSO`. # SAML SSO details. Must be set if and only if `sso_mode` is set to `SAML_SSO`. "inboundSamlSsoProfile": "A String", # Required. Name of the `InboundSamlSsoProfile` to use. Must be of the form `inboundSamlSsoProfiles/{inbound_saml_sso_profile}`. @@ -239,6 +245,9 @@

Method Details

{ # Targets with "set" SSO assignments and their respective assignments. "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`. "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the Inbound SSO Assignment. + "oidcSsoInfo": { # Details that are applicable when `sso_mode` is set to `OIDC_SSO`. # OpenID Connect SSO details. Must be set if and only if `sso_mode` is set to `OIDC_SSO`. + "inboundOidcSsoProfile": "A String", # Required. Name of the `InboundOidcSsoProfile` to use. Must be of the form `inboundOidcSsoProfiles/{inbound_oidc_sso_profile}`. + }, "rank": 42, # Must be zero (which is the default value so it can be omitted) for assignments with `target_org_unit` set and must be greater-than-or-equal-to one for assignments with `target_group` set. "samlSsoInfo": { # Details that are applicable when `sso_mode` == `SAML_SSO`. # SAML SSO details. Must be set if and only if `sso_mode` is set to `SAML_SSO`. "inboundSamlSsoProfile": "A String", # Required. Name of the `InboundSamlSsoProfile` to use. Must be of the form `inboundSamlSsoProfiles/{inbound_saml_sso_profile}`. @@ -281,6 +290,9 @@

Method Details

{ # Targets with "set" SSO assignments and their respective assignments. "customer": "A String", # Immutable. The customer. For example: `customers/C0123abc`. "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the Inbound SSO Assignment. + "oidcSsoInfo": { # Details that are applicable when `sso_mode` is set to `OIDC_SSO`. # OpenID Connect SSO details. Must be set if and only if `sso_mode` is set to `OIDC_SSO`. + "inboundOidcSsoProfile": "A String", # Required. Name of the `InboundOidcSsoProfile` to use. Must be of the form `inboundOidcSsoProfiles/{inbound_oidc_sso_profile}`. + }, "rank": 42, # Must be zero (which is the default value so it can be omitted) for assignments with `target_org_unit` set and must be greater-than-or-equal-to one for assignments with `target_group` set. "samlSsoInfo": { # Details that are applicable when `sso_mode` == `SAML_SSO`. # SAML SSO details. Must be set if and only if `sso_mode` is set to `SAML_SSO`. "inboundSamlSsoProfile": "A String", # Required. Name of the `InboundSamlSsoProfile` to use. Must be of the form `inboundSamlSsoProfiles/{inbound_saml_sso_profile}`. diff --git a/googleapiclient/discovery_cache/documents/cloudidentity.v1.json b/googleapiclient/discovery_cache/documents/cloudidentity.v1.json index 75471c60126..9a51b3241cc 100644 --- a/googleapiclient/discovery_cache/documents/cloudidentity.v1.json +++ b/googleapiclient/discovery_cache/documents/cloudidentity.v1.json @@ -1605,6 +1605,151 @@ } } }, +"inboundOidcSsoProfiles": { +"methods": { +"create": { +"description": "Creates an InboundOidcSsoProfile for a customer. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `\"done\": false`, it will not have a response, and the metadata will have `\"state\": \"awaiting-multi-party-approval\"`.", +"flatPath": "v1/inboundOidcSsoProfiles", +"httpMethod": "POST", +"id": "cloudidentity.inboundOidcSsoProfiles.create", +"parameterOrder": [], +"parameters": {}, +"path": "v1/inboundOidcSsoProfiles", +"request": { +"$ref": "InboundOidcSsoProfile" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-identity.inboundsso", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"delete": { +"description": "Deletes an InboundOidcSsoProfile.", +"flatPath": "v1/inboundOidcSsoProfiles/{inboundOidcSsoProfilesId}", +"httpMethod": "DELETE", +"id": "cloudidentity.inboundOidcSsoProfiles.delete", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The [resource name](https://cloud.google.com/apis/design/resource_names) of the InboundOidcSsoProfile to delete. Format: `inboundOidcSsoProfiles/{sso_profile_id}`", +"location": "path", +"pattern": "^inboundOidcSsoProfiles/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-identity.inboundsso", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"get": { +"description": "Gets an InboundOidcSsoProfile.", +"flatPath": "v1/inboundOidcSsoProfiles/{inboundOidcSsoProfilesId}", +"httpMethod": "GET", +"id": "cloudidentity.inboundOidcSsoProfiles.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The [resource name](https://cloud.google.com/apis/design/resource_names) of the InboundOidcSsoProfile to get. Format: `inboundOidcSsoProfiles/{sso_profile_id}`", +"location": "path", +"pattern": "^inboundOidcSsoProfiles/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}", +"response": { +"$ref": "InboundOidcSsoProfile" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-identity.inboundsso", +"https://www.googleapis.com/auth/cloud-identity.inboundsso.readonly", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"list": { +"description": "Lists InboundOidcSsoProfile objects for a Google enterprise customer.", +"flatPath": "v1/inboundOidcSsoProfiles", +"httpMethod": "GET", +"id": "cloudidentity.inboundOidcSsoProfiles.list", +"parameterOrder": [], +"parameters": { +"filter": { +"description": "A [Common Expression Language](https://github.com/google/cel-spec) expression to filter the results. The only supported filter is filtering by customer. For example: `customer==\"customers/C0123abc\"`. Omitting the filter or specifying a filter of `customer==\"customers/my_customer\"` will return the profiles for the customer that the caller (authenticated user) belongs to. Specifying a filter of `customer==\"\"` will return the global shared OIDC profiles.", +"location": "query", +"type": "string" +}, +"pageSize": { +"description": "The maximum number of InboundOidcSsoProfiles to return. The service may return fewer than this value. If omitted (or defaulted to zero) the server will use a sensible default. This default may change over time. The maximum allowed value is 100. Requests with page_size greater than that will be silently interpreted as having this maximum value.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "A page token, received from a previous `ListInboundOidcSsoProfiles` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListInboundOidcSsoProfiles` must match the call that provided the page token.", +"location": "query", +"type": "string" +} +}, +"path": "v1/inboundOidcSsoProfiles", +"response": { +"$ref": "ListInboundOidcSsoProfilesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-identity.inboundsso", +"https://www.googleapis.com/auth/cloud-identity.inboundsso.readonly", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"patch": { +"description": "Updates an InboundOidcSsoProfile. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `\"done\": false`, it will not have a response, and the metadata will have `\"state\": \"awaiting-multi-party-approval\"`.", +"flatPath": "v1/inboundOidcSsoProfiles/{inboundOidcSsoProfilesId}", +"httpMethod": "PATCH", +"id": "cloudidentity.inboundOidcSsoProfiles.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.", +"location": "path", +"pattern": "^inboundOidcSsoProfiles/[^/]+$", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Required. The list of fields to be updated.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "InboundOidcSsoProfile" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-identity.inboundsso", +"https://www.googleapis.com/auth/cloud-platform" +] +} +} +}, "inboundSamlSsoProfiles": { "methods": { "create": { @@ -2085,7 +2230,7 @@ } } }, -"revision": "20250701", +"revision": "20250805", "rootUrl": "https://cloudidentity.googleapis.com/", "schemas": { "AddIdpCredentialOperationMetadata": { @@ -2133,6 +2278,17 @@ "properties": {}, "type": "object" }, +"CreateInboundOidcSsoProfileOperationMetadata": { +"description": "LRO response metadata for InboundOidcSsoProfilesService.CreateInboundOidcSsoProfile.", +"id": "CreateInboundOidcSsoProfileOperationMetadata", +"properties": { +"state": { +"description": "State of this Operation Will be \"awaiting-multi-party-approval\" when the operation is deferred due to the target customer having enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448).", +"type": "string" +} +}, +"type": "object" +}, "CreateInboundSamlSsoProfileOperationMetadata": { "description": "LRO response metadata for InboundSamlSsoProfilesService.CreateInboundSamlSsoProfile.", "id": "CreateInboundSamlSsoProfileOperationMetadata", @@ -2168,6 +2324,12 @@ "properties": {}, "type": "object" }, +"DeleteInboundOidcSsoProfileOperationMetadata": { +"description": "LRO response metadata for InboundOidcSsoProfilesService.DeleteInboundOidcSsoProfile.", +"id": "DeleteInboundOidcSsoProfileOperationMetadata", +"properties": {}, +"type": "object" +}, "DeleteInboundSamlSsoProfileOperationMetadata": { "description": "LRO response metadata for InboundSamlSsoProfilesService.DeleteInboundSamlSsoProfile.", "id": "DeleteInboundSamlSsoProfileOperationMetadata", @@ -3494,6 +3656,34 @@ }, "type": "object" }, +"InboundOidcSsoProfile": { +"description": "An [OIDC](https://openid.net/developers/how-connect-works/) federation between a Google enterprise customer and an OIDC identity provider.", +"id": "InboundOidcSsoProfile", +"properties": { +"customer": { +"description": "Immutable. The customer. For example: `customers/C0123abc`.", +"type": "string" +}, +"displayName": { +"description": "Human-readable name of the OIDC SSO profile.", +"type": "string" +}, +"idpConfig": { +"$ref": "OidcIdpConfig", +"description": "OIDC identity provider configuration." +}, +"name": { +"description": "Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.", +"readOnly": true, +"type": "string" +}, +"rpConfig": { +"$ref": "OidcRpConfig", +"description": "OIDC relying party (RP) configuration for this OIDC SSO profile. These are the RP details provided by Google that should be configured on the corresponding identity provider." +} +}, +"type": "object" +}, "InboundSamlSsoProfile": { "description": "A [SAML 2.0](https://www.oasis-open.org/standards#samlv2.0) federation between a Google enterprise customer and a SAML identity provider.", "id": "InboundSamlSsoProfile", @@ -3535,6 +3725,10 @@ "readOnly": true, "type": "string" }, +"oidcSsoInfo": { +"$ref": "OidcSsoInfo", +"description": "OpenID Connect SSO details. Must be set if and only if `sso_mode` is set to `OIDC_SSO`." +}, "rank": { "description": "Must be zero (which is the default value so it can be omitted) for assignments with `target_org_unit` set and must be greater-than-or-equal-to one for assignments with `target_group` set.", "format": "int32", @@ -3554,12 +3748,14 @@ "SSO_MODE_UNSPECIFIED", "SSO_OFF", "SAML_SSO", +"OIDC_SSO", "DOMAIN_WIDE_SAML_IF_ENABLED" ], "enumDescriptions": [ "Not allowed.", "Disable SSO for the targeted users.", "Use an external SAML Identity Provider for SSO for the targeted users.", +"Use an external OIDC Identity Provider for SSO for the targeted users.", "Use the domain-wide SAML Identity Provider for the targeted users if one is configured; otherwise, this is equivalent to `SSO_OFF`. Note that this will also be equivalent to `SSO_OFF` if/when support for domain-wide SAML is removed. Google may disallow this mode at that point and existing assignments with this mode may be automatically changed to `SSO_OFF`." ], "type": "string" @@ -3622,6 +3818,24 @@ }, "type": "object" }, +"ListInboundOidcSsoProfilesResponse": { +"description": "Response of the InboundOidcSsoProfilesService.ListInboundOidcSsoProfiles method.", +"id": "ListInboundOidcSsoProfilesResponse", +"properties": { +"inboundOidcSsoProfiles": { +"description": "List of InboundOidcSsoProfiles.", +"items": { +"$ref": "InboundOidcSsoProfile" +}, +"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" +}, "ListInboundSamlSsoProfilesResponse": { "description": "Response of the InboundSamlSsoProfilesService.ListInboundSamlSsoProfiles method.", "id": "ListInboundSamlSsoProfilesResponse", @@ -4012,6 +4226,55 @@ }, "type": "object" }, +"OidcIdpConfig": { +"description": "OIDC IDP (identity provider) configuration.", +"id": "OidcIdpConfig", +"properties": { +"changePasswordUri": { +"description": "The **Change Password URL** of the identity provider. Users will be sent to this URL when changing their passwords at `myaccount.google.com`. This takes precedence over the change password URL configured at customer-level. Must use `HTTPS`.", +"type": "string" +}, +"issuerUri": { +"description": "Required. The Issuer identifier for the IdP. Must be a URL. The discovery URL will be derived from this as described in Section 4 of [the OIDC specification](https://openid.net/specs/openid-connect-discovery-1_0.html).", +"type": "string" +} +}, +"type": "object" +}, +"OidcRpConfig": { +"description": "OIDC RP (relying party) configuration.", +"id": "OidcRpConfig", +"properties": { +"clientId": { +"description": "OAuth2 client ID for OIDC.", +"type": "string" +}, +"clientSecret": { +"description": "Input only. OAuth2 client secret for OIDC.", +"type": "string" +}, +"redirectUris": { +"description": "Output only. The URL(s) that this client may use in authentication requests.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"OidcSsoInfo": { +"description": "Details that are applicable when `sso_mode` is set to `OIDC_SSO`.", +"id": "OidcSsoInfo", +"properties": { +"inboundOidcSsoProfile": { +"description": "Required. Name of the `InboundOidcSsoProfile` to use. Must be of the form `inboundOidcSsoProfiles/{inbound_oidc_sso_profile}`. ", +"type": "string" +} +}, +"type": "object" +}, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -4387,6 +4650,17 @@ "properties": {}, "type": "object" }, +"UpdateInboundOidcSsoProfileOperationMetadata": { +"description": "LRO response metadata for InboundOidcSsoProfilesService.UpdateInboundOidcSsoProfile.", +"id": "UpdateInboundOidcSsoProfileOperationMetadata", +"properties": { +"state": { +"description": "State of this Operation Will be \"awaiting-multi-party-approval\" when the operation is deferred due to the target customer having enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448).", +"type": "string" +} +}, +"type": "object" +}, "UpdateInboundSamlSsoProfileOperationMetadata": { "description": "LRO response metadata for InboundSamlSsoProfilesService.UpdateInboundSamlSsoProfile.", "id": "UpdateInboundSamlSsoProfileOperationMetadata", diff --git a/googleapiclient/discovery_cache/documents/cloudidentity.v1beta1.json b/googleapiclient/discovery_cache/documents/cloudidentity.v1beta1.json index 23a24e349b2..6160beaf363 100644 --- a/googleapiclient/discovery_cache/documents/cloudidentity.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/cloudidentity.v1beta1.json @@ -1560,6 +1560,151 @@ } } }, +"inboundOidcSsoProfiles": { +"methods": { +"create": { +"description": "Creates an InboundOidcSsoProfile for a customer. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `\"done\": false`, it will not have a response, and the metadata will have `\"state\": \"awaiting-multi-party-approval\"`.", +"flatPath": "v1beta1/inboundOidcSsoProfiles", +"httpMethod": "POST", +"id": "cloudidentity.inboundOidcSsoProfiles.create", +"parameterOrder": [], +"parameters": {}, +"path": "v1beta1/inboundOidcSsoProfiles", +"request": { +"$ref": "InboundOidcSsoProfile" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-identity.inboundsso", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"delete": { +"description": "Deletes an InboundOidcSsoProfile.", +"flatPath": "v1beta1/inboundOidcSsoProfiles/{inboundOidcSsoProfilesId}", +"httpMethod": "DELETE", +"id": "cloudidentity.inboundOidcSsoProfiles.delete", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The [resource name](https://cloud.google.com/apis/design/resource_names) of the InboundOidcSsoProfile to delete. Format: `inboundOidcSsoProfiles/{sso_profile_id}`", +"location": "path", +"pattern": "^inboundOidcSsoProfiles/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1beta1/{+name}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-identity.inboundsso", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"get": { +"description": "Gets an InboundOidcSsoProfile.", +"flatPath": "v1beta1/inboundOidcSsoProfiles/{inboundOidcSsoProfilesId}", +"httpMethod": "GET", +"id": "cloudidentity.inboundOidcSsoProfiles.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The [resource name](https://cloud.google.com/apis/design/resource_names) of the InboundOidcSsoProfile to get. Format: `inboundOidcSsoProfiles/{sso_profile_id}`", +"location": "path", +"pattern": "^inboundOidcSsoProfiles/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1beta1/{+name}", +"response": { +"$ref": "InboundOidcSsoProfile" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-identity.inboundsso", +"https://www.googleapis.com/auth/cloud-identity.inboundsso.readonly", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"list": { +"description": "Lists InboundOidcSsoProfile objects for a Google enterprise customer.", +"flatPath": "v1beta1/inboundOidcSsoProfiles", +"httpMethod": "GET", +"id": "cloudidentity.inboundOidcSsoProfiles.list", +"parameterOrder": [], +"parameters": { +"filter": { +"description": "A [Common Expression Language](https://github.com/google/cel-spec) expression to filter the results. The only supported filter is filtering by customer. For example: `customer==\"customers/C0123abc\"`. Omitting the filter or specifying a filter of `customer==\"customers/my_customer\"` will return the profiles for the customer that the caller (authenticated user) belongs to. Specifying a filter of `customer==\"\"` will return the global shared OIDC profiles.", +"location": "query", +"type": "string" +}, +"pageSize": { +"description": "The maximum number of InboundOidcSsoProfiles to return. The service may return fewer than this value. If omitted (or defaulted to zero) the server will use a sensible default. This default may change over time. The maximum allowed value is 100. Requests with page_size greater than that will be silently interpreted as having this maximum value.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "A page token, received from a previous `ListInboundOidcSsoProfiles` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListInboundOidcSsoProfiles` must match the call that provided the page token.", +"location": "query", +"type": "string" +} +}, +"path": "v1beta1/inboundOidcSsoProfiles", +"response": { +"$ref": "ListInboundOidcSsoProfilesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-identity.inboundsso", +"https://www.googleapis.com/auth/cloud-identity.inboundsso.readonly", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"patch": { +"description": "Updates an InboundOidcSsoProfile. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `\"done\": false`, it will not have a response, and the metadata will have `\"state\": \"awaiting-multi-party-approval\"`.", +"flatPath": "v1beta1/inboundOidcSsoProfiles/{inboundOidcSsoProfilesId}", +"httpMethod": "PATCH", +"id": "cloudidentity.inboundOidcSsoProfiles.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.", +"location": "path", +"pattern": "^inboundOidcSsoProfiles/[^/]+$", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Required. The list of fields to be updated.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1beta1/{+name}", +"request": { +"$ref": "InboundOidcSsoProfile" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-identity.inboundsso", +"https://www.googleapis.com/auth/cloud-platform" +] +} +} +}, "inboundSamlSsoProfiles": { "methods": { "create": { @@ -2123,7 +2268,7 @@ } } }, -"revision": "20250701", +"revision": "20250805", "rootUrl": "https://cloudidentity.googleapis.com/", "schemas": { "AddIdpCredentialOperationMetadata": { @@ -2630,6 +2775,17 @@ }, "type": "object" }, +"CreateInboundOidcSsoProfileOperationMetadata": { +"description": "LRO response metadata for InboundOidcSsoProfilesService.CreateInboundOidcSsoProfile.", +"id": "CreateInboundOidcSsoProfileOperationMetadata", +"properties": { +"state": { +"description": "State of this Operation Will be \"awaiting-multi-party-approval\" when the operation is deferred due to the target customer having enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448).", +"type": "string" +} +}, +"type": "object" +}, "CreateInboundSamlSsoProfileOperationMetadata": { "description": "LRO response metadata for InboundSamlSsoProfilesService.CreateInboundSamlSsoProfile.", "id": "CreateInboundSamlSsoProfileOperationMetadata", @@ -2673,6 +2829,12 @@ "properties": {}, "type": "object" }, +"DeleteInboundOidcSsoProfileOperationMetadata": { +"description": "LRO response metadata for InboundOidcSsoProfilesService.DeleteInboundOidcSsoProfile.", +"id": "DeleteInboundOidcSsoProfileOperationMetadata", +"properties": {}, +"type": "object" +}, "DeleteInboundSamlSsoProfileOperationMetadata": { "description": "LRO response metadata for InboundSamlSsoProfilesService.DeleteInboundSamlSsoProfile.", "id": "DeleteInboundSamlSsoProfileOperationMetadata", @@ -4233,6 +4395,34 @@ }, "type": "object" }, +"InboundOidcSsoProfile": { +"description": "An [OIDC](https://openid.net/developers/how-connect-works/) federation between a Google enterprise customer and an OIDC identity provider.", +"id": "InboundOidcSsoProfile", +"properties": { +"customer": { +"description": "Immutable. The customer. For example: `customers/C0123abc`.", +"type": "string" +}, +"displayName": { +"description": "Human-readable name of the OIDC SSO profile.", +"type": "string" +}, +"idpConfig": { +"$ref": "OidcIdpConfig", +"description": "OIDC identity provider configuration." +}, +"name": { +"description": "Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the OIDC SSO profile.", +"readOnly": true, +"type": "string" +}, +"rpConfig": { +"$ref": "OidcRpConfig", +"description": "OIDC relying party (RP) configuration for this OIDC SSO profile. These are the RP details provided by Google that should be configured on the corresponding identity provider." +} +}, +"type": "object" +}, "InboundSamlSsoProfile": { "description": "A [SAML 2.0](https://www.oasis-open.org/standards#samlv2.0) federation between a Google enterprise customer and a SAML identity provider.", "id": "InboundSamlSsoProfile", @@ -4274,6 +4464,10 @@ "readOnly": true, "type": "string" }, +"oidcSsoInfo": { +"$ref": "OidcSsoInfo", +"description": "OpenID Connect SSO details. Must be set if and only if `sso_mode` is set to `OIDC_SSO`." +}, "rank": { "description": "Must be zero (which is the default value so it can be omitted) for assignments with `target_org_unit` set and must be greater-than-or-equal-to one for assignments with `target_group` set.", "format": "int32", @@ -4293,12 +4487,14 @@ "SSO_MODE_UNSPECIFIED", "SSO_OFF", "SAML_SSO", +"OIDC_SSO", "DOMAIN_WIDE_SAML_IF_ENABLED" ], "enumDescriptions": [ "Not allowed.", "Disable SSO for the targeted users.", "Use an external SAML Identity Provider for SSO for the targeted users.", +"Use an external OIDC Identity Provider for SSO for the targeted users.", "Use the domain-wide SAML Identity Provider for the targeted users if one is configured; otherwise, this is equivalent to `SSO_OFF`. Note that this will also be equivalent to `SSO_OFF` if/when support for domain-wide SAML is removed. Google may disallow this mode at that point and existing assignments with this mode may be automatically changed to `SSO_OFF`." ], "type": "string" @@ -4415,6 +4611,24 @@ }, "type": "object" }, +"ListInboundOidcSsoProfilesResponse": { +"description": "Response of the InboundOidcSsoProfilesService.ListInboundOidcSsoProfiles method.", +"id": "ListInboundOidcSsoProfilesResponse", +"properties": { +"inboundOidcSsoProfiles": { +"description": "List of InboundOidcSsoProfiles.", +"items": { +"$ref": "InboundOidcSsoProfile" +}, +"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" +}, "ListInboundSamlSsoProfilesResponse": { "description": "Response of the InboundSamlSsoProfilesService.ListInboundSamlSsoProfiles method.", "id": "ListInboundSamlSsoProfilesResponse", @@ -4865,6 +5079,55 @@ }, "type": "object" }, +"OidcIdpConfig": { +"description": "OIDC IDP (identity provider) configuration.", +"id": "OidcIdpConfig", +"properties": { +"changePasswordUri": { +"description": "The **Change Password URL** of the identity provider. Users will be sent to this URL when changing their passwords at `myaccount.google.com`. This takes precedence over the change password URL configured at customer-level. Must use `HTTPS`.", +"type": "string" +}, +"issuerUri": { +"description": "Required. The Issuer identifier for the IdP. Must be a URL. The discovery URL will be derived from this as described in Section 4 of [the OIDC specification](https://openid.net/specs/openid-connect-discovery-1_0.html).", +"type": "string" +} +}, +"type": "object" +}, +"OidcRpConfig": { +"description": "OIDC RP (relying party) configuration.", +"id": "OidcRpConfig", +"properties": { +"clientId": { +"description": "OAuth2 client ID for OIDC.", +"type": "string" +}, +"clientSecret": { +"description": "Input only. OAuth2 client secret for OIDC.", +"type": "string" +}, +"redirectUris": { +"description": "Output only. The URL(s) that this client may use in authentication requests.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, +"OidcSsoInfo": { +"description": "Details that are applicable when `sso_mode` is set to `OIDC_SSO`.", +"id": "OidcSsoInfo", +"properties": { +"inboundOidcSsoProfile": { +"description": "Required. Name of the `InboundOidcSsoProfile` to use. Must be of the form `inboundOidcSsoProfiles/{inbound_oidc_sso_profile}`. ", +"type": "string" +} +}, +"type": "object" +}, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -5285,6 +5548,17 @@ }, "type": "object" }, +"UpdateInboundOidcSsoProfileOperationMetadata": { +"description": "LRO response metadata for InboundOidcSsoProfilesService.UpdateInboundOidcSsoProfile.", +"id": "UpdateInboundOidcSsoProfileOperationMetadata", +"properties": { +"state": { +"description": "State of this Operation Will be \"awaiting-multi-party-approval\" when the operation is deferred due to the target customer having enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448).", +"type": "string" +} +}, +"type": "object" +}, "UpdateInboundSamlSsoProfileOperationMetadata": { "description": "LRO response metadata for InboundSamlSsoProfilesService.UpdateInboundSamlSsoProfile.", "id": "UpdateInboundSamlSsoProfileOperationMetadata", From 706356057c42c8a3939bb41422fa17e01e528f7e Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:58 +0000 Subject: [PATCH 12/32] feat(cloudkms): update the api #### cloudkms:v1 The following keys were added: - resources.projects.resources.locations.resources.keyRings.resources.cryptoKeys.resources.cryptoKeyVersions.methods.decapsulate (Total Keys: 12) - schemas.DecapsulateRequest (Total Keys: 6) - schemas.DecapsulateResponse (Total Keys: 9) --- ...keyRings.cryptoKeys.cryptoKeyVersions.html | 36 +++++ .../documents/cloudkms.v1.json | 137 +++++++++++++++++- 2 files changed, 166 insertions(+), 7 deletions(-) diff --git a/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html b/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html index 39f963249e7..da8d98b5141 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html +++ b/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html @@ -86,6 +86,9 @@

Instance Methods

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

Create a new CryptoKeyVersion in a CryptoKey. The server will assign the next sequential id. If unset, state will be set to ENABLED.

+

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

+

Decapsulates data that was encapsulated with a public key retrieved from GetPublicKey corresponding to a CryptoKeyVersion with CryptoKey.purpose KEY_ENCAPSULATION.

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

Schedule a CryptoKeyVersion for destruction. Upon calling this method, CryptoKeyVersion.state will be set to DESTROY_SCHEDULED, and destroy_time will be set to the time destroy_scheduled_duration in the future. At that time, the state will automatically change to DESTROYED, and the key material will be irrevocably destroyed. Before the destroy_time is reached, RestoreCryptoKeyVersion may be called to reverse the process.

@@ -286,6 +289,37 @@

Method Details

} +
+ decapsulate(name, body=None, x__xgafv=None) + 
Decapsulates data that was encapsulated with a public key retrieved from GetPublicKey corresponding to a CryptoKeyVersion with CryptoKey.purpose KEY_ENCAPSULATION.
+
+Args:
+  name: string, Required. The resource name of the CryptoKeyVersion to use for decapsulation. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for KeyManagementService.Decapsulate.
+  "ciphertext": "A String", # Required. The ciphertext produced from encapsulation with the named CryptoKeyVersion public key(s).
+  "ciphertextCrc32c": "A String", # Optional. A CRC32C checksum of the DecapsulateRequest.ciphertext. If specified, KeyManagementService will verify the integrity of the received DecapsulateRequest.ciphertext using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C(DecapsulateRequest.ciphertext) is equal to DecapsulateRequest.ciphertext_crc32c, and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.
+}
+
+  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 KeyManagementService.Decapsulate.
+  "name": "A String", # The resource name of the CryptoKeyVersion used for decapsulation. Check this field to verify that the intended resource was used for decapsulation.
+  "protectionLevel": "A String", # The ProtectionLevel of the CryptoKeyVersion used in decapsulation.
+  "sharedSecret": "A String", # The decapsulated shared_secret originally encapsulated with the matching public key.
+  "sharedSecretCrc32c": "A String", # Integrity verification field. A CRC32C checksum of the returned DecapsulateResponse.shared_secret. An integrity check of DecapsulateResponse.shared_secret can be performed by computing the CRC32C checksum of DecapsulateResponse.shared_secret and comparing your results to this field. Discard the response in case of non-matching checksum values, and perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: receiving this response message indicates that KeyManagementService is able to successfully decrypt the ciphertext. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.
+  "verifiedCiphertextCrc32c": True or False, # Integrity verification field. A flag indicating whether DecapsulateRequest.ciphertext_crc32c was received by KeyManagementService and used for the integrity verification of the ciphertext. A false value of this field indicates either that DecapsulateRequest.ciphertext_crc32c was left unset or that it was not delivered to KeyManagementService. If you've set DecapsulateRequest.ciphertext_crc32c but this field is still false, discard the response and perform a limited number of retries.
+}
+
+
destroy(name, body=None, x__xgafv=None) 
Schedule a CryptoKeyVersion for destruction. Upon calling this method, CryptoKeyVersion.state will be set to DESTROY_SCHEDULED, and destroy_time will be set to the time destroy_scheduled_duration in the future. At that time, the state will automatically change to DESTROYED, and the key material will be irrevocably destroyed. Before the destroy_time is reached, RestoreCryptoKeyVersion may be called to reverse the process.
@@ -404,7 +438,9 @@ 
Method Details

     Allowed values
       PUBLIC_KEY_FORMAT_UNSPECIFIED - If the public_key_format field is not specified: - For PQC algorithms, an error will be returned. - For non-PQC algorithms, the default format is PEM, and the field pem will be populated. Otherwise, the public key will be exported through the public_key field in the requested format.
       PEM - The returned public key will be encoded in PEM format. See the [RFC7468](https://tools.ietf.org/html/rfc7468) sections for [General Considerations](https://tools.ietf.org/html/rfc7468#section-2) and [Textual Encoding of Subject Public Key Info] (https://tools.ietf.org/html/rfc7468#section-13) for more information.
+      DER - The returned public key will be encoded in DER format (the PrivateKeyInfo structure from RFC 5208).
       NIST_PQC - This is supported only for PQC algorithms. The key material is returned in the format defined by NIST PQC standards (FIPS 203, FIPS 204, and FIPS 205).
+      XWING_RAW_BYTES - The returned public key is in raw bytes format defined in its standard https://datatracker.ietf.org/doc/draft-connolly-cfrg-xwing-kem.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/googleapiclient/discovery_cache/documents/cloudkms.v1.json b/googleapiclient/discovery_cache/documents/cloudkms.v1.json
index a643b96151b..9c738d9dd5e 100644
--- a/googleapiclient/discovery_cache/documents/cloudkms.v1.json
+++ b/googleapiclient/discovery_cache/documents/cloudkms.v1.json
@@ -1795,6 +1795,35 @@
 "https://www.googleapis.com/auth/cloudkms"
 ]
 },
+"decapsulate": {
+"description": "Decapsulates data that was encapsulated with a public key retrieved from GetPublicKey corresponding to a CryptoKeyVersion with CryptoKey.purpose KEY_ENCAPSULATION.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/keyRings/{keyRingsId}/cryptoKeys/{cryptoKeysId}/cryptoKeyVersions/{cryptoKeyVersionsId}:decapsulate",
+"httpMethod": "POST",
+"id": "cloudkms.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.decapsulate",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the CryptoKeyVersion to use for decapsulation.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+/cryptoKeyVersions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}:decapsulate",
+"request": {
+"$ref": "DecapsulateRequest"
+},
+"response": {
+"$ref": "DecapsulateResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/cloudkms"
+]
+},
 "destroy": {
 "description": "Schedule a CryptoKeyVersion for destruction. Upon calling this method, CryptoKeyVersion.state will be set to DESTROY_SCHEDULED, and destroy_time will be set to the time destroy_scheduled_duration in the future. At that time, the state will automatically change to DESTROYED, and the key material will be irrevocably destroyed. Before the destroy_time is reached, RestoreCryptoKeyVersion may be called to reverse the process.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/keyRings/{keyRingsId}/cryptoKeys/{cryptoKeysId}/cryptoKeyVersions/{cryptoKeyVersionsId}:destroy",
@@ -1871,12 +1900,16 @@
 "enum": [
 "PUBLIC_KEY_FORMAT_UNSPECIFIED",
 "PEM",
-"NIST_PQC"
+"DER",
+"NIST_PQC",
+"XWING_RAW_BYTES"
 ],
 "enumDescriptions": [
 "If the public_key_format field is not specified: - For PQC algorithms, an error will be returned. - For non-PQC algorithms, the default format is PEM, and the field pem will be populated. Otherwise, the public key will be exported through the public_key field in the requested format.",
 "The returned public key will be encoded in PEM format. See the [RFC7468](https://tools.ietf.org/html/rfc7468) sections for [General Considerations](https://tools.ietf.org/html/rfc7468#section-2) and [Textual Encoding of Subject Public Key Info] (https://tools.ietf.org/html/rfc7468#section-13) for more information.",
-"This is supported only for PQC algorithms. The key material is returned in the format defined by NIST PQC standards (FIPS 203, FIPS 204, and FIPS 205)."
+"The returned public key will be encoded in DER format (the PrivateKeyInfo structure from RFC 5208).",
+"This is supported only for PQC algorithms. The key material is returned in the format defined by NIST PQC standards (FIPS 203, FIPS 204, and FIPS 205).",
+"The returned public key is in raw bytes format defined in its standard https://datatracker.ietf.org/doc/draft-connolly-cfrg-xwing-kem."
 ],
 "location": "query",
 "type": "string"
@@ -2402,7 +2435,7 @@
 }
 }
 },
-"revision": "20250523",
+"revision": "20250731",
 "rootUrl": "https://cloudkms.googleapis.com/",
 "schemas": {
 "AsymmetricDecryptRequest": {
@@ -2799,7 +2832,8 @@
 "ASYMMETRIC_SIGN",
 "ASYMMETRIC_DECRYPT",
 "RAW_ENCRYPT_DECRYPT",
-"MAC"
+"MAC",
+"KEY_ENCAPSULATION"
 ],
 "enumDescriptions": [
 "Not specified.",
@@ -2807,7 +2841,8 @@
 "CryptoKeys with this purpose may be used with AsymmetricSign and GetPublicKey.",
 "CryptoKeys with this purpose may be used with AsymmetricDecrypt and GetPublicKey.",
 "CryptoKeys with this purpose may be used with RawEncrypt and RawDecrypt. This purpose is meant to be used for interoperable symmetric encryption and does not support automatic CryptoKey rotation.",
-"CryptoKeys with this purpose may be used with MacSign."
+"CryptoKeys with this purpose may be used with MacSign.",
+"CryptoKeys with this purpose may be used with GetPublicKey and Decapsulate."
 ],
 "type": "string"
 },
@@ -2866,6 +2901,9 @@
 "HMAC_SHA512",
 "HMAC_SHA224",
 "EXTERNAL_SYMMETRIC_ENCRYPTION",
+"ML_KEM_768",
+"ML_KEM_1024",
+"KEM_XWING",
 "PQ_SIGN_ML_DSA_65",
 "PQ_SIGN_SLH_DSA_SHA2_128S",
 "PQ_SIGN_HASH_SLH_DSA_SHA2_128S_SHA256"
@@ -2907,6 +2945,9 @@
 "HMAC-SHA512 signing with a 512 bit key.",
 "HMAC-SHA224 signing with a 224 bit key.",
 "Algorithm representing symmetric encryption by an external key manager.",
+"ML-KEM-768 (FIPS 203)",
+"ML-KEM-1024 (FIPS 203)",
+"X-Wing hybrid KEM combining ML-KEM-768 with X25519 following datatracker.ietf.org/doc/draft-connolly-cfrg-xwing-kem/.",
 "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 3. Randomized version.",
 "The post-quantum stateless hash-based digital signature algorithm, at security level 1. Randomized version.",
 "The post-quantum stateless hash-based digital signature algorithm, at security level 1. Randomized pre-hash version supporting SHA256 digests."
@@ -3078,6 +3119,9 @@
 "HMAC_SHA512",
 "HMAC_SHA224",
 "EXTERNAL_SYMMETRIC_ENCRYPTION",
+"ML_KEM_768",
+"ML_KEM_1024",
+"KEM_XWING",
 "PQ_SIGN_ML_DSA_65",
 "PQ_SIGN_SLH_DSA_SHA2_128S",
 "PQ_SIGN_HASH_SLH_DSA_SHA2_128S_SHA256"
@@ -3119,6 +3163,9 @@
 "HMAC-SHA512 signing with a 512 bit key.",
 "HMAC-SHA224 signing with a 224 bit key.",
 "Algorithm representing symmetric encryption by an external key manager.",
+"ML-KEM-768 (FIPS 203)",
+"ML-KEM-1024 (FIPS 203)",
+"X-Wing hybrid KEM combining ML-KEM-768 with X25519 following datatracker.ietf.org/doc/draft-connolly-cfrg-xwing-kem/.",
 "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 3. Randomized version.",
 "The post-quantum stateless hash-based digital signature algorithm, at security level 1. Randomized version.",
 "The post-quantum stateless hash-based digital signature algorithm, at security level 1. Randomized pre-hash version supporting SHA256 digests."
@@ -3146,6 +3193,66 @@
 },
 "type": "object"
 },
+"DecapsulateRequest": {
+"description": "Request message for KeyManagementService.Decapsulate.",
+"id": "DecapsulateRequest",
+"properties": {
+"ciphertext": {
+"description": "Required. The ciphertext produced from encapsulation with the named CryptoKeyVersion public key(s).",
+"format": "byte",
+"type": "string"
+},
+"ciphertextCrc32c": {
+"description": "Optional. A CRC32C checksum of the DecapsulateRequest.ciphertext. If specified, KeyManagementService will verify the integrity of the received DecapsulateRequest.ciphertext using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C(DecapsulateRequest.ciphertext) is equal to DecapsulateRequest.ciphertext_crc32c, and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"DecapsulateResponse": {
+"description": "Response message for KeyManagementService.Decapsulate.",
+"id": "DecapsulateResponse",
+"properties": {
+"name": {
+"description": "The resource name of the CryptoKeyVersion used for decapsulation. Check this field to verify that the intended resource was used for decapsulation.",
+"type": "string"
+},
+"protectionLevel": {
+"description": "The ProtectionLevel of the CryptoKeyVersion used in decapsulation.",
+"enum": [
+"PROTECTION_LEVEL_UNSPECIFIED",
+"SOFTWARE",
+"HSM",
+"EXTERNAL",
+"EXTERNAL_VPC"
+],
+"enumDescriptions": [
+"Not specified.",
+"Crypto operations are performed in software.",
+"Crypto operations are performed in a Hardware Security Module.",
+"Crypto operations are performed by an external key manager.",
+"Crypto operations are performed in an EKM-over-VPC backend."
+],
+"type": "string"
+},
+"sharedSecret": {
+"description": "The decapsulated shared_secret originally encapsulated with the matching public key.",
+"format": "byte",
+"type": "string"
+},
+"sharedSecretCrc32c": {
+"description": "Integrity verification field. A CRC32C checksum of the returned DecapsulateResponse.shared_secret. An integrity check of DecapsulateResponse.shared_secret can be performed by computing the CRC32C checksum of DecapsulateResponse.shared_secret and comparing your results to this field. Discard the response in case of non-matching checksum values, and perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: receiving this response message indicates that KeyManagementService is able to successfully decrypt the ciphertext. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.",
+"format": "int64",
+"type": "string"
+},
+"verifiedCiphertextCrc32c": {
+"description": "Integrity verification field. A flag indicating whether DecapsulateRequest.ciphertext_crc32c was received by KeyManagementService and used for the integrity verification of the ciphertext. A false value of this field indicates either that DecapsulateRequest.ciphertext_crc32c was left unset or that it was not delivered to KeyManagementService. If you've set DecapsulateRequest.ciphertext_crc32c but this field is still false, discard the response and perform a limited number of retries.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "DecryptRequest": {
 "description": "Request message for KeyManagementService.Decrypt.",
 "id": "DecryptRequest",
@@ -3505,6 +3612,9 @@
 "HMAC_SHA512",
 "HMAC_SHA224",
 "EXTERNAL_SYMMETRIC_ENCRYPTION",
+"ML_KEM_768",
+"ML_KEM_1024",
+"KEM_XWING",
 "PQ_SIGN_ML_DSA_65",
 "PQ_SIGN_SLH_DSA_SHA2_128S",
 "PQ_SIGN_HASH_SLH_DSA_SHA2_128S_SHA256"
@@ -3546,6 +3656,9 @@
 "HMAC-SHA512 signing with a 512 bit key.",
 "HMAC-SHA224 signing with a 224 bit key.",
 "Algorithm representing symmetric encryption by an external key manager.",
+"ML-KEM-768 (FIPS 203)",
+"ML-KEM-1024 (FIPS 203)",
+"X-Wing hybrid KEM combining ML-KEM-768 with X25519 following datatracker.ietf.org/doc/draft-connolly-cfrg-xwing-kem/.",
 "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 3. Randomized version.",
 "The post-quantum stateless hash-based digital signature algorithm, at security level 1. Randomized version.",
 "The post-quantum stateless hash-based digital signature algorithm, at security level 1. Randomized pre-hash version supporting SHA256 digests."
@@ -4260,6 +4373,9 @@
 "HMAC_SHA512",
 "HMAC_SHA224",
 "EXTERNAL_SYMMETRIC_ENCRYPTION",
+"ML_KEM_768",
+"ML_KEM_1024",
+"KEM_XWING",
 "PQ_SIGN_ML_DSA_65",
 "PQ_SIGN_SLH_DSA_SHA2_128S",
 "PQ_SIGN_HASH_SLH_DSA_SHA2_128S_SHA256"
@@ -4301,6 +4417,9 @@
 "HMAC-SHA512 signing with a 512 bit key.",
 "HMAC-SHA224 signing with a 224 bit key.",
 "Algorithm representing symmetric encryption by an external key manager.",
+"ML-KEM-768 (FIPS 203)",
+"ML-KEM-1024 (FIPS 203)",
+"X-Wing hybrid KEM combining ML-KEM-768 with X25519 following datatracker.ietf.org/doc/draft-connolly-cfrg-xwing-kem/.",
 "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 3. Randomized version.",
 "The post-quantum stateless hash-based digital signature algorithm, at security level 1. Randomized version.",
 "The post-quantum stateless hash-based digital signature algorithm, at security level 1. Randomized pre-hash version supporting SHA256 digests."
@@ -4347,12 +4466,16 @@
 "enum": [
 "PUBLIC_KEY_FORMAT_UNSPECIFIED",
 "PEM",
-"NIST_PQC"
+"DER",
+"NIST_PQC",
+"XWING_RAW_BYTES"
 ],
 "enumDescriptions": [
 "If the public_key_format field is not specified: - For PQC algorithms, an error will be returned. - For non-PQC algorithms, the default format is PEM, and the field pem will be populated. Otherwise, the public key will be exported through the public_key field in the requested format.",
 "The returned public key will be encoded in PEM format. See the [RFC7468](https://tools.ietf.org/html/rfc7468) sections for [General Considerations](https://tools.ietf.org/html/rfc7468#section-2) and [Textual Encoding of Subject Public Key Info] (https://tools.ietf.org/html/rfc7468#section-13) for more information.",
-"This is supported only for PQC algorithms. The key material is returned in the format defined by NIST PQC standards (FIPS 203, FIPS 204, and FIPS 205)."
+"The returned public key will be encoded in DER format (the PrivateKeyInfo structure from RFC 5208).",
+"This is supported only for PQC algorithms. The key material is returned in the format defined by NIST PQC standards (FIPS 203, FIPS 204, and FIPS 205).",
+"The returned public key is in raw bytes format defined in its standard https://datatracker.ietf.org/doc/draft-connolly-cfrg-xwing-kem."
 ],
 "type": "string"
 }

From 38c4209338d9e81a75fd2254a5869fd4d024234e Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:09:58 +0000
Subject: [PATCH 13/32] feat(cloudsupport): update the api

#### cloudsupport:v2beta

The following keys were added:
- resources.cases.resources.attachments.methods.get (Total Keys: 11)
- resources.cases.resources.comments.methods.get (Total Keys: 11)
---
 ...cloudsupport_v2beta.cases.attachments.html | 32 ++++++++++++
 .../cloudsupport_v2beta.cases.comments.html   | 31 +++++++++++
 .../documents/cloudsupport.v2beta.json        | 52 ++++++++++++++++++-
 3 files changed, 114 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/cloudsupport_v2beta.cases.attachments.html b/docs/dyn/cloudsupport_v2beta.cases.attachments.html
index c75a4e933a1..336e9f6b016 100644
--- a/docs/dyn/cloudsupport_v2beta.cases.attachments.html
+++ b/docs/dyn/cloudsupport_v2beta.cases.attachments.html
@@ -77,6 +77,9 @@ 
Instance Methods

 

   close()

 
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

+
Retrieve an attachment associated with a support case. EXAMPLES: cURL: ```shell attachment="projects/some-project/cases/23598314/attachments/0684M00000P3h1fQAB" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$attachment" ``` Python: ```python import googleapiclient.discovery api_version = "v2beta" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .attachments() .get(name="projects/some-project/cases/43595344/attachments/0684M00000P3h1fQAB") ) print(request.execute()) ```

 

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

 
List all the attachments associated with a support case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/23598314" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case/attachments" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .attachments() .list(parent="projects/some-project/cases/43595344") ) print(request.execute()) ```

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

   
Close httplib2 connections.
+
+ get(name, x__xgafv=None) + 
Retrieve an attachment associated with a support case. EXAMPLES: cURL: ```shell attachment="projects/some-project/cases/23598314/attachments/0684M00000P3h1fQAB" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$attachment" ``` Python: ```python import googleapiclient.discovery api_version = "v2beta" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .attachments() .get(name="projects/some-project/cases/43595344/attachments/0684M00000P3h1fQAB") ) print(request.execute()) ```
+
+Args:
+  name: string, Required. The name of the attachment to get. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An Attachment contains metadata about a file that was uploaded to a case - it is NOT a file itself. That being said, the name of an Attachment object can be used to download its accompanying file through the `media.download` endpoint. While attachments can be uploaded in the console at the same time as a comment, they're associated on a "case" level, not a "comment" level.
+  "createTime": "A String", # Output only. The time at which the attachment was created.
+  "creator": { # An Actor represents an entity that performed an action. For example, an actor could be a user who posted a comment on a support case, a user who uploaded an attachment, or a service account that created a support case. # Output only. The user who uploaded the attachment. Note, the name and email will be obfuscated if the attachment was uploaded by Google support.
+    "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent.
+    "email": "A String", # The email address of the actor. If not provided, it is inferred from the credentials supplied during case creation. When a name is provided, an email must also be provided. If the user is a Google Support agent, this is obfuscated. This field is deprecated. Use `username` instead.
+    "googleSupport": True or False, # Output only. Whether the actor is a Google support actor.
+    "username": "A String", # Output only. The username of the actor. It may look like an email or other format provided by the identity provider. If not provided, it is inferred from the credentials supplied. When a name is provided, a username must also be provided. If the user is a Google Support agent, this will not be set.
+  },
+  "filename": "A String", # The filename of the attachment (e.g. `"graph.jpg"`).
+  "mimeType": "A String", # Output only. The MIME type of the attachment (e.g. text/plain).
+  "name": "A String", # Output only. Identifier. The resource name of the attachment.
+  "sizeBytes": "A String", # Output only. The size of the attachment in bytes.
+}
+
+
list(parent, pageSize=None, pageToken=None, x__xgafv=None) 
List all the attachments associated with a support case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/23598314" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case/attachments" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .attachments() .list(parent="projects/some-project/cases/43595344") ) print(request.execute()) ```
diff --git a/docs/dyn/cloudsupport_v2beta.cases.comments.html b/docs/dyn/cloudsupport_v2beta.cases.comments.html
index 0c80605f0df..69eb6b78a08 100644
--- a/docs/dyn/cloudsupport_v2beta.cases.comments.html
+++ b/docs/dyn/cloudsupport_v2beta.cases.comments.html
@@ -80,6 +80,9 @@ 
Instance Methods

 

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

 
Add a new comment to a case. The comment must have the following fields set: `body`. EXAMPLES: cURL: ```shell case="projects/some-project/cases/43591344" curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header 'Content-Type: application/json' \ --data '{ "body": "This is a test comment." }' \ "https://cloudsupport.googleapis.com/v2/$case/comments" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .comments() .create( parent="projects/some-project/cases/43595344", body={"body": "This is a test comment."}, ) ) print(request.execute()) ```

+

+  get(name, x__xgafv=None)

+
Retrieve a comment. EXAMPLES: cURL: ```shell comment="projects/some-project/cases/43595344/comments/234567890" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$comment" ``` Python: ```python import googleapiclient.discovery api_version = "v2beta" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().comments().get( name="projects/some-project/cases/43595344/comments/234567890", ) print(request.execute()) ```

 

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

 
List all the comments associated with a case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/43595344" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case/comments" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .comments() .list(parent="projects/some-project/cases/43595344") ) print(request.execute()) ```

@@ -136,6 +139,34 @@ 
Method Details

 }
+
+ get(name, x__xgafv=None) + 
Retrieve a comment. EXAMPLES: cURL: ```shell comment="projects/some-project/cases/43595344/comments/234567890" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$comment" ``` Python: ```python import googleapiclient.discovery api_version = "v2beta" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().comments().get( name="projects/some-project/cases/43595344/comments/234567890", ) print(request.execute()) ```
+
+Args:
+  name: string, Required. The name of the comment 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 comment associated with a support case. Case comments are the primary way for Google Support to communicate with a user who has opened a case. When a user responds to Google Support, the user's responses also appear as comments.
+  "body": "A String", # The full comment body. Maximum of 12800 characters.
+  "createTime": "A String", # Output only. The time when the comment was created.
+  "creator": { # An Actor represents an entity that performed an action. For example, an actor could be a user who posted a comment on a support case, a user who uploaded an attachment, or a service account that created a support case. # Output only. The user or Google Support agent who created the comment.
+    "displayName": "A String", # The name to display for the actor. If not provided, it is inferred from credentials supplied during case creation. When an email is provided, a display name must also be provided. This will be obfuscated if the user is a Google Support agent.
+    "email": "A String", # The email address of the actor. If not provided, it is inferred from the credentials supplied during case creation. When a name is provided, an email must also be provided. If the user is a Google Support agent, this is obfuscated. This field is deprecated. Use `username` instead.
+    "googleSupport": True or False, # Output only. Whether the actor is a Google support actor.
+    "username": "A String", # Output only. The username of the actor. It may look like an email or other format provided by the identity provider. If not provided, it is inferred from the credentials supplied. When a name is provided, a username must also be provided. If the user is a Google Support agent, this will not be set.
+  },
+  "name": "A String", # Output only. Identifier. The resource name of the comment.
+  "plainTextBody": "A String", # Output only. DEPRECATED. DO NOT USE. A duplicate of the `body` field. This field is only present for legacy reasons.
+}
+
+
list(parent, pageSize=None, pageToken=None, x__xgafv=None) 
List all the comments associated with a case. EXAMPLES: cURL: ```shell case="projects/some-project/cases/43595344" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case/comments" ``` Python: ```python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = ( supportApiService.cases() .comments() .list(parent="projects/some-project/cases/43595344") ) print(request.execute()) ```
diff --git a/googleapiclient/discovery_cache/documents/cloudsupport.v2beta.json b/googleapiclient/discovery_cache/documents/cloudsupport.v2beta.json
index 8fef4e5d4e0..cbaf5e64ea5 100644
--- a/googleapiclient/discovery_cache/documents/cloudsupport.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/cloudsupport.v2beta.json
@@ -439,6 +439,31 @@
 "resources": {
 "attachments": {
 "methods": {
+"get": {
+"description": "Retrieve an attachment associated with a support case. EXAMPLES: cURL: ```shell attachment=\"projects/some-project/cases/23598314/attachments/0684M00000P3h1fQAB\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ \"https://cloudsupport.googleapis.com/v2/$attachment\" ``` Python: ```python import googleapiclient.discovery api_version = \"v2beta\" supportApiService = googleapiclient.discovery.build( serviceName=\"cloudsupport\", version=api_version, discoveryServiceUrl=f\"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}\", ) request = ( supportApiService.cases() .attachments() .get(name=\"projects/some-project/cases/43595344/attachments/0684M00000P3h1fQAB\") ) print(request.execute()) ```",
+"flatPath": "v2beta/{v2betaId}/{v2betaId1}/cases/{casesId}/attachments/{attachmentsId}",
+"httpMethod": "GET",
+"id": "cloudsupport.cases.attachments.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the attachment to get.",
+"location": "path",
+"pattern": "^[^/]+/[^/]+/cases/[^/]+/attachments/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2beta/{+name}",
+"response": {
+"$ref": "Attachment"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "list": {
 "description": "List all the attachments associated with a support case. EXAMPLES: cURL: ```shell case=\"projects/some-project/cases/23598314\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ \"https://cloudsupport.googleapis.com/v2/$case/attachments\" ``` Python: ```python import googleapiclient.discovery api_version = \"v2\" supportApiService = googleapiclient.discovery.build( serviceName=\"cloudsupport\", version=api_version, discoveryServiceUrl=f\"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}\", ) request = ( supportApiService.cases() .attachments() .list(parent=\"projects/some-project/cases/43595344\") ) print(request.execute()) ```",
 "flatPath": "v2beta/{v2betaId}/{v2betaId1}/cases/{casesId}/attachments",
@@ -507,6 +532,31 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"get": {
+"description": "Retrieve a comment. EXAMPLES: cURL: ```shell comment=\"projects/some-project/cases/43595344/comments/234567890\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ \"https://cloudsupport.googleapis.com/v2/$comment\" ``` Python: ```python import googleapiclient.discovery api_version = \"v2beta\" supportApiService = googleapiclient.discovery.build( serviceName=\"cloudsupport\", version=api_version, discoveryServiceUrl=f\"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}\", ) request = supportApiService.cases().comments().get( name=\"projects/some-project/cases/43595344/comments/234567890\", ) print(request.execute()) ```",
+"flatPath": "v2beta/{v2betaId}/{v2betaId1}/cases/{casesId}/comments/{commentsId}",
+"httpMethod": "GET",
+"id": "cloudsupport.cases.comments.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the comment to retrieve.",
+"location": "path",
+"pattern": "^[^/]+/[^/]+/cases/[^/]+/comments/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2beta/{+name}",
+"response": {
+"$ref": "Comment"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "list": {
 "description": "List all the comments associated with a case. EXAMPLES: cURL: ```shell case=\"projects/some-project/cases/43595344\" curl \\ --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\ \"https://cloudsupport.googleapis.com/v2/$case/comments\" ``` Python: ```python import googleapiclient.discovery api_version = \"v2\" supportApiService = googleapiclient.discovery.build( serviceName=\"cloudsupport\", version=api_version, discoveryServiceUrl=f\"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}\", ) request = ( supportApiService.cases() .comments() .list(parent=\"projects/some-project/cases/43595344\") ) print(request.execute()) ```",
 "flatPath": "v2beta/{v2betaId}/{v2betaId1}/cases/{casesId}/comments",
@@ -619,7 +669,7 @@
 }
 }
 },
-"revision": "20250609",
+"revision": "20250806",
 "rootUrl": "https://cloudsupport.googleapis.com/",
 "schemas": {
 "Actor": {

From 34f2f0cea03bac9f172300dcc25ae64274560a8c Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:09:59 +0000
Subject: [PATCH 14/32] feat(compute): update the api

#### compute:alpha

The following keys were added:
- resources.haControllers.methods.delete (Total Keys: 20)
- resources.haControllers.methods.get (Total Keys: 19)
- resources.haControllers.methods.insert (Total Keys: 18)
- resources.haControllers.methods.list (Total Keys: 28)
- resources.haControllers.methods.patch (Total Keys: 25)
- resources.regionHealthAggregationPolicies.methods.aggregatedList (Total Keys: 29)
- resources.reservationSubBlocks.methods.reportFaulty (Total Keys: 22)
- schemas.AllocationAggregateReservation.properties.hostCount (Total Keys: 2)
- schemas.AllocationAggregateReservation.properties.inUseHostCount (Total Keys: 2)
- schemas.AllocationAggregateReservation.properties.inUseInstanceCount (Total Keys: 2)
- schemas.Backend.properties.maxInFlightRequests (Total Keys: 6)
- schemas.Backend.properties.trafficDuration.type (Total Keys: 1)
- schemas.ExternalVpnGateway.properties.params.$ref (Total Keys: 1)
- schemas.ExternalVpnGatewayParams (Total Keys: 4)
- schemas.FutureReservation.properties.protectionTier.type (Total Keys: 1)
- schemas.HaController (Total Keys: 104)
- schemas.HealthAggregationPoliciesScopedList (Total Keys: 11)
- schemas.HealthAggregationPolicyAggregatedList (Total Keys: 18)
- schemas.MultiMigStatus.properties.appliedAcceleratorTopologies (Total Keys: 2)
- schemas.MultiMigStatusAcceleratorTopology (Total Keys: 21)
- schemas.NetworkProfileNetworkFeatures.properties.allowFirewallPolicy.type (Total Keys: 1)
- schemas.NetworkProfileNetworkFeatures.properties.allowVpcFirewallRules.type (Total Keys: 1)
- schemas.NetworkProfileNetworkFeatures.properties.firewallPolicyTypes (Total Keys: 2)
- schemas.ReservationBlock.properties.inUseHostCount (Total Keys: 2)
- schemas.ReservationSubBlock.properties.inUseHostCount (Total Keys: 2)
- schemas.ReservationSubBlocksReportFaultyRequest (Total Keys: 9)
- schemas.ResourceStatus.properties.consumedReservation.deprecated (Total Keys: 1)
- schemas.ResourceStatus.properties.consumedReservationBlock.deprecated (Total Keys: 1)
- schemas.TargetVpnGateway.properties.params.$ref (Total Keys: 1)
- schemas.TargetVpnGatewayParams (Total Keys: 4)
- schemas.VpnGateway.properties.params.$ref (Total Keys: 1)
- schemas.VpnGatewayParams (Total Keys: 4)
- schemas.VpnTunnel.properties.params.$ref (Total Keys: 1)
- schemas.VpnTunnelParams (Total Keys: 4)

#### compute:beta

The following keys were added:
- schemas.Backend.properties.maxInFlightRequests (Total Keys: 6)
- schemas.Backend.properties.trafficDuration.type (Total Keys: 1)
- schemas.ManagedInstance.properties.scheduling.$ref (Total Keys: 1)
- schemas.ManagedInstanceScheduling (Total Keys: 4)
- schemas.Reservation.properties.advancedDeploymentControl.$ref (Total Keys: 1)
- schemas.ReservationAdvancedDeploymentControl (Total Keys: 3)

#### compute:v1

The following keys were added:
- resources.networks.methods.requestRemovePeering (Total Keys: 18)
- schemas.BackendBucket.properties.params.$ref (Total Keys: 1)
- schemas.BackendBucketParams (Total Keys: 4)
- schemas.BackendService.properties.params.$ref (Total Keys: 1)
- schemas.BackendServiceParams (Total Keys: 4)
- schemas.Interconnect.properties.aaiEnabled.type (Total Keys: 1)
- schemas.Interconnect.properties.applicationAwareInterconnect.$ref (Total Keys: 1)
- schemas.InterconnectApplicationAwareInterconnect (Total Keys: 17)
- schemas.NetworkPeering.properties.connectionStatus.$ref (Total Keys: 1)
- schemas.NetworkPeering.properties.updateStrategy.type (Total Keys: 1)
- schemas.NetworkPeeringConnectionStatus (Total Keys: 16)
- schemas.NetworksRequestRemovePeeringRequest (Total Keys: 3)
- schemas.Reservation.properties.advancedDeploymentControl.$ref (Total Keys: 1)
- schemas.ReservationAdvancedDeploymentControl (Total Keys: 3)
---
 docs/dyn/compute_alpha.advice.html            |    2 +-
 docs/dyn/compute_alpha.backendServices.html   |   28 +
 .../compute_alpha.externalVpnGateways.html    |   15 +
 .../dyn/compute_alpha.futureReservations.html |   20 +
 docs/dyn/compute_alpha.haControllers.html     | 1035 ++++++++
 docs/dyn/compute_alpha.networkProfiles.html   |   10 +
 .../compute_alpha.regionBackendServices.html  |   24 +
 docs/dyn/compute_alpha.regionCommitments.html |   18 +
 ...alpha.regionHealthAggregationPolicies.html |   92 +
 docs/dyn/compute_alpha.regionMultiMigs.html   |  153 ++
 docs/dyn/compute_alpha.reservationBlocks.html |    2 +
 .../compute_alpha.reservationSubBlocks.html   |  146 ++
 docs/dyn/compute_alpha.reservations.html      |   15 +
 docs/dyn/compute_alpha.resourcePolicies.html  |   40 +-
 docs/dyn/compute_alpha.targetVpnGateways.html |   20 +
 docs/dyn/compute_alpha.vpnGateways.html       |   20 +
 docs/dyn/compute_alpha.vpnTunnels.html        |   20 +
 docs/dyn/compute_beta.backendServices.html    |   28 +
 .../compute_beta.instanceGroupManagers.html   |    3 +
 .../compute_beta.regionBackendServices.html   |   24 +
 docs/dyn/compute_beta.regionCommitments.html  |   18 +
 ...pute_beta.regionInstanceGroupManagers.html |    3 +
 docs/dyn/compute_beta.reservations.html       |   15 +
 docs/dyn/compute_beta.resourcePolicies.html   |   40 +-
 docs/dyn/compute_v1.backendBuckets.html       |   25 +
 docs/dyn/compute_v1.backendServices.html      |   35 +
 docs/dyn/compute_v1.interconnects.html        |   80 +
 docs/dyn/compute_v1.networks.html             |  224 ++
 .../dyn/compute_v1.regionBackendServices.html |   30 +
 docs/dyn/compute_v1.regionCommitments.html    |   15 +
 docs/dyn/compute_v1.reservations.html         |   15 +
 docs/dyn/compute_v1.resourcePolicies.html     |   40 +-
 .../documents/compute.alpha.json              | 2100 ++++++++++++++---
 .../documents/compute.beta.json               |   82 +-
 .../discovery_cache/documents/compute.v1.json |  328 ++-
 35 files changed, 4422 insertions(+), 343 deletions(-)

diff --git a/docs/dyn/compute_alpha.advice.html b/docs/dyn/compute_alpha.advice.html
index 1b89d4a8276..6d8020ceb8e 100644
--- a/docs/dyn/compute_alpha.advice.html
+++ b/docs/dyn/compute_alpha.advice.html
@@ -210,7 +210,7 @@ 
Method Details

   An object of the form:
 
     { # A response contains multiple scoring recommendations.
-  "recommendations": [ # Initially the API will provide one recommendation which balances the individual scores according to Google's preference.
+  "recommendations": [ # Initially the API will provide one recommendation which balances the individual scores according to service provider's preference.
     {
       "scores": { # The Scores message groups information about a shard of capacity.
         "obtainability": 3.14, # The obtainability score indicates the likelihood of successfully obtaining (provisioning) the requested number of VMs. The score range is 0.0 through 1.0. Higher is better.
diff --git a/docs/dyn/compute_alpha.backendServices.html b/docs/dyn/compute_alpha.backendServices.html
index ed0f51b85fc..20e04877146 100644
--- a/docs/dyn/compute_alpha.backendServices.html
+++ b/docs/dyn/compute_alpha.backendServices.html
@@ -317,11 +317,15 @@ 
Method Details

               "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
               "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
               "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
+              "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION.
+              "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION.
+              "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION.
               "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
               "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
               "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
               "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.
               "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default
+              "trafficDuration": "A String",
             },
           ],
           "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types.
@@ -1120,11 +1124,15 @@ 
Method Details

       "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
       "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
       "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION.
       "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.
       "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default
+      "trafficDuration": "A String",
     },
   ],
   "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types.
@@ -2003,11 +2011,15 @@ 
Method Details

       "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
       "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
       "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION.
       "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.
       "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default
+      "trafficDuration": "A String",
     },
   ],
   "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types.
@@ -2630,11 +2642,15 @@ 
Method Details

           "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
           "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
           "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
+          "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION.
+          "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION.
+          "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION.
           "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
           "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
           "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
           "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.
           "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default
+          "trafficDuration": "A String",
         },
       ],
       "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types.
@@ -3155,11 +3171,15 @@ 
Method Details

           "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
           "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
           "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
+          "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION.
+          "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION.
+          "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION.
           "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
           "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
           "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
           "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.
           "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default
+          "trafficDuration": "A String",
         },
       ],
       "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types.
@@ -3696,11 +3716,15 @@ 
Method Details

       "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
       "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
       "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION.
       "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.
       "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default
+      "trafficDuration": "A String",
     },
   ],
   "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types.
@@ -4706,11 +4730,15 @@ 
Method Details

       "maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
       "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
       "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
+      "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION.
+      "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION.
+      "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION.
       "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
       "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.
       "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default
+      "trafficDuration": "A String",
     },
   ],
   "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types.
diff --git a/docs/dyn/compute_alpha.externalVpnGateways.html b/docs/dyn/compute_alpha.externalVpnGateways.html
index 20d892e9c59..fe9db18f900 100644
--- a/docs/dyn/compute_alpha.externalVpnGateways.html
+++ b/docs/dyn/compute_alpha.externalVpnGateways.html
@@ -261,6 +261,11 @@ 
Method Details

     "a_key": "A String",
   },
   "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.
+    "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid.
+      "a_key": "A String",
+    },
+  },
   "redundancyType": "A String", # Indicates the user-supplied redundancy type of this external VPN gateway.
   "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
 }
@@ -292,6 +297,11 @@

Method Details

"a_key": "A String", }, "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "redundancyType": "A String", # Indicates the user-supplied redundancy type of this external VPN gateway. "selfLink": "A String", # [Output Only] Server-defined URL for the resource. } @@ -454,6 +464,11 @@

Method Details

"a_key": "A String", }, "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "redundancyType": "A String", # Indicates the user-supplied redundancy type of this external VPN gateway. "selfLink": "A String", # [Output Only] Server-defined URL for the resource. }, diff --git a/docs/dyn/compute_alpha.futureReservations.html b/docs/dyn/compute_alpha.futureReservations.html index 366906ef2ad..73184551854 100644 --- a/docs/dyn/compute_alpha.futureReservations.html +++ b/docs/dyn/compute_alpha.futureReservations.html @@ -134,6 +134,9 @@

Method Details

"futureReservations": [ # A list of future reservations contained in this scope. { "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Aggregate reservation details for the future reservation. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -173,6 +176,7 @@

Method Details

"name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "namePrefix": "A String", # Name prefix for the reservations to be created at the time of delivery. The name prefix must comply with RFC1035. Maximum allowed length for name prefix is 20. Automatically created reservations name format will be -date-####. "planningStatus": "A String", # Planning state before being submitted for evaluation + "protectionTier": "A String", # Protection tier for the workload. "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and expected pricing. "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of delivery of future reservations. If the reservation with the given name does not exist already, it is created automatically at the time of Approval with INACTIVE state till specified start-time. Either provide the reservation_name or a name_prefix. "schedulingType": "A String", # Maintenance information for this reservation @@ -624,6 +628,9 @@

Method Details

{ "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Aggregate reservation details for the future reservation. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -663,6 +670,7 @@

Method Details

"name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "namePrefix": "A String", # Name prefix for the reservations to be created at the time of delivery. The name prefix must comply with RFC1035. Maximum allowed length for name prefix is 20. Automatically created reservations name format will be -date-####. "planningStatus": "A String", # Planning state before being submitted for evaluation + "protectionTier": "A String", # Protection tier for the workload. "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and expected pricing. "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of delivery of future reservations. If the reservation with the given name does not exist already, it is created automatically at the time of Approval with INACTIVE state till specified start-time. Either provide the reservation_name or a name_prefix. "schedulingType": "A String", # Maintenance information for this reservation @@ -807,6 +815,9 @@

Method Details

{ "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Aggregate reservation details for the future reservation. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -846,6 +857,7 @@

Method Details

"name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "namePrefix": "A String", # Name prefix for the reservations to be created at the time of delivery. The name prefix must comply with RFC1035. Maximum allowed length for name prefix is 20. Automatically created reservations name format will be -date-####. "planningStatus": "A String", # Planning state before being submitted for evaluation + "protectionTier": "A String", # Protection tier for the workload. "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and expected pricing. "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of delivery of future reservations. If the reservation with the given name does not exist already, it is created automatically at the time of Approval with INACTIVE state till specified start-time. Either provide the reservation_name or a name_prefix. "schedulingType": "A String", # Maintenance information for this reservation @@ -1121,6 +1133,9 @@

Method Details

"items": [ # [Output Only] A list of future reservation resources. { "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Aggregate reservation details for the future reservation. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -1160,6 +1175,7 @@

Method Details

"name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "namePrefix": "A String", # Name prefix for the reservations to be created at the time of delivery. The name prefix must comply with RFC1035. Maximum allowed length for name prefix is 20. Automatically created reservations name format will be -date-####. "planningStatus": "A String", # Planning state before being submitted for evaluation + "protectionTier": "A String", # Protection tier for the workload. "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and expected pricing. "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of delivery of future reservations. If the reservation with the given name does not exist already, it is created automatically at the time of Approval with INACTIVE state till specified start-time. Either provide the reservation_name or a name_prefix. "schedulingType": "A String", # Maintenance information for this reservation @@ -1337,6 +1353,9 @@

Method Details

{ "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Aggregate reservation details for the future reservation. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -1376,6 +1395,7 @@

Method Details

"name": "A String", # The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "namePrefix": "A String", # Name prefix for the reservations to be created at the time of delivery. The name prefix must comply with RFC1035. Maximum allowed length for name prefix is 20. Automatically created reservations name format will be -date-####. "planningStatus": "A String", # Planning state before being submitted for evaluation + "protectionTier": "A String", # Protection tier for the workload. "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and expected pricing. "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of delivery of future reservations. If the reservation with the given name does not exist already, it is created automatically at the time of Approval with INACTIVE state till specified start-time. Either provide the reservation_name or a name_prefix. "schedulingType": "A String", # Maintenance information for this reservation diff --git a/docs/dyn/compute_alpha.haControllers.html b/docs/dyn/compute_alpha.haControllers.html index 48569fbc20e..a8993913dba 100644 --- a/docs/dyn/compute_alpha.haControllers.html +++ b/docs/dyn/compute_alpha.haControllers.html @@ -77,15 +77,159 @@

Instance Methods

close()

Close httplib2 connections.

+

+ delete(project, region, haController, requestId=None, x__xgafv=None)

+

Deletes an HaController in the specified project.

failover(project, region, haController, body=None, requestId=None, x__xgafv=None)

Fails over a VM targeted by the specified HaController to the selected zone.

+

+ get(project, region, haController, x__xgafv=None)

+

Returns all the details of a specific HaController.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Creates HaController in the specified project.

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

+

Lists all HaControllers in the specified project in the specified region.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, haController, body=None, requestId=None, updateMask=None, x__xgafv=None)

+

Updates HaController in the specified project.

Method Details

close() 
Close httplib2 connections.
+
+ delete(project, region, haController, requestId=None, x__xgafv=None) + 
Deletes an HaController in the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  haController: string, Name of the HaController resource to delete. (required)
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource. Google Compute Engine has three Operation resources: * [Global](/compute/docs/reference/rest/alpha/globalOperations) * [Regional](/compute/docs/reference/rest/alpha/regionOperations) * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations) You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses. Operations can be global, regional or zonal. - For global operations, use the `globalOperations` resource. - For regional operations, use the `regionOperations` resource. - For zonal operations, use the `zoneOperations` resource. For more information, read Global, Regional, and Zonal Resources. Note that completed Operation resources have a limited retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a `404` means the resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key). Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # [Output Only] Server-defined URL for this resource with the resource id.
+  "setCommonInstanceMetadataOperationMetadata": { # [Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key). Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # [Output Only] If state is `ABANDONED` or `FAILED`, this field is populated.
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+        },
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com` or `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+        {
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
+        },
+      ],
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
+    },
+  ],
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
+}
+
+
failover(project, region, haController, body=None, requestId=None, x__xgafv=None) 
Fails over a VM targeted by the specified HaController to the selected zone.
@@ -219,4 +363,895 @@ 
Method Details

 }
+
+ get(project, region, haController, x__xgafv=None) + 
Returns all the details of a specific HaController.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  haController: string, Name of the HaController resource to return. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # HaController handles failover for a VM Instance.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+  "failoverInitiation": "A String", # Indicates how failover should be initiated.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+  "instanceName": "A String", # Name of the instance that HaController is in charge of. If not specified the HaController's resource name will be used instead. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  "kind": "compute#HaController", # [Output Only] Type of the resource. Always compute#haController for HaControllers.
+  "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  "region": "A String", # [Output Only] URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
+  "secondaryZoneCapacity": "A String", # Indicates the capacity guarantees in the secondary zone.
+  "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # [Output Only] Server-defined URL for this resource with the resource id.
+  "status": { # Contains information about current status of the HaController. # [Output Only] Status information for the HaController resource.
+    "failoverProgress": { # Contains information about the current failover operation. # [Output Only] Contains the details of the ongoing failover. This message is not displayed if failover is NOT in progress.
+      "failoverTrigger": "A String", # [Output Only] Indicates if failover has been triggered automatically or manually.
+      "failoverTriggerTimestamp": "A String", # [Output Only] Timestamp of the last failover trigger.
+      "lastFailoverAttempt": { # [Output Only] Contains details of the last failed failover. This field is filled only if the current failover is failing
+        "errors": { # [Output Only] Encountered errors during the last attempt to process failover.
+          "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+            {
+              "code": "A String", # [Output Only] The error type identifier for this error.
+              "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+                {
+                  "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+                    "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+                    "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                      "a_key": "A String",
+                    },
+                    "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+                  },
+                  "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+                    "links": [ # URL(s) pointing to additional information on handling the current error.
+                      { # Describes a URL link.
+                        "description": "A String", # Describes what the link offers.
+                        "url": "A String", # The URL of the link.
+                      },
+                    ],
+                  },
+                  "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+                    "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+                    "message": "A String", # The localized error message in the above locale.
+                  },
+                  "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+                    "dimensions": { # The map holding related quota dimensions.
+                      "a_key": "A String",
+                    },
+                    "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+                    "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+                    "limitName": "A String", # The name of the quota limit.
+                    "metricName": "A String", # The Compute Engine quota metric name.
+                    "rolloutStatus": "A String", # Rollout status of the future quota limit.
+                  },
+                },
+              ],
+              "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+              "message": "A String", # [Output Only] An optional, human-readable error message.
+            },
+          ],
+        },
+        "timestamp": "A String", # [Output Only] Show timestamp only if there is an error. RFC3339 text format.
+      },
+    },
+    "ongoingFailover": True or False, # [Output Only] Indicates if the failover is currently in-progress.
+    "primaryInstance": "A String", # [Output Only] The URL to the instance that is intended to be primary at this moment. Primary instance will be changed at the very beginning of a failover operation.
+    "primaryZone": "A String", # [Output Only] The name of the zone that is intended to be primary at this moment. Primary zone will be changed at the very beginning of a failover operation. The zone may not be operational in the middle of a failover operation.
+    "readyForFailover": True or False, # [Output Only] Indicates if the resource is ready for initiating a failover to the secondary zone.
+    "zoneStatus": { # [Output Only] Map of zone statuses. Key: name of the zone Value: ZoneStatus
+      "a_key": { # Contains the status of a specific zone.
+        "isPrimary": True or False, # [Output Only] Indicates if the zone is primary at this moment.
+        "isZoneReady": True or False, # [Output Only] Indicates if the zone is ready for initiating a failover.
+        "lastError": { # Contains details of the last failed operation. # [Output Only] This field is filled only if the current operation is failing.
+          "errors": { # [Output Only] Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+              {
+                "code": "A String", # [Output Only] The error type identifier for this error.
+                "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+                  {
+                    "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+                      "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+                      "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                        "a_key": "A String",
+                      },
+                      "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+                    },
+                    "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+                      "links": [ # URL(s) pointing to additional information on handling the current error.
+                        { # Describes a URL link.
+                          "description": "A String", # Describes what the link offers.
+                          "url": "A String", # The URL of the link.
+                        },
+                      ],
+                    },
+                    "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+                      "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+                      "message": "A String", # The localized error message in the above locale.
+                    },
+                    "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+                      "dimensions": { # The map holding related quota dimensions.
+                        "a_key": "A String",
+                      },
+                      "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+                      "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+                      "limitName": "A String", # The name of the quota limit.
+                      "metricName": "A String", # The Compute Engine quota metric name.
+                      "rolloutStatus": "A String", # Rollout status of the future quota limit.
+                    },
+                  },
+                ],
+                "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+                "message": "A String", # [Output Only] An optional, human-readable error message.
+              },
+            ],
+          },
+          "timestamp": "A String", # [Output Only] Show timestamp only if there is an error. RFC3339 text format.
+        },
+      },
+    },
+  },
+  "zoneConfigurations": { # Map of zone configurations Key: name of the zone Value: ZoneConfiguration
+    "a_key": { # Config for a zone that the HaController may use for running the VM instance.
+      "nodeAffinities": [ # A set of node affinity configurations. Refer to Configuring node affinity for more information. Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which the Instance could be scheduled. This message should be an exact copy of the Instances representation of NodeAffinity. LINT.IfChange(HaControllerNodeAffinityMixer)
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "reservationAffinity": { # Specifies the reservations that this instance can consume from. This message should be an exact copy of the Instances representation of AllocationAffinity. LINT.IfChange(HaControllerAllocationAffinityMixer) # Specifies the reservations that the instance can consume from.
+        "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples.
+        "key": "A String", # Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, specify googleapis.com/reservation-name as the key and specify the name of your reservation as its value.
+        "values": [ # Corresponds to the label values of a reservation resource. This can be either a name to a reservation in the same project or "projects/different-project/reservations/some-reservation-name" to target a shared reservation in the same zone but in a different project.
+          "A String",
+        ],
+      },
+    },
+  },
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) + 
Creates HaController in the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # HaController handles failover for a VM Instance.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+  "failoverInitiation": "A String", # Indicates how failover should be initiated.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+  "instanceName": "A String", # Name of the instance that HaController is in charge of. If not specified the HaController's resource name will be used instead. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  "kind": "compute#HaController", # [Output Only] Type of the resource. Always compute#haController for HaControllers.
+  "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  "region": "A String", # [Output Only] URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
+  "secondaryZoneCapacity": "A String", # Indicates the capacity guarantees in the secondary zone.
+  "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # [Output Only] Server-defined URL for this resource with the resource id.
+  "status": { # Contains information about current status of the HaController. # [Output Only] Status information for the HaController resource.
+    "failoverProgress": { # Contains information about the current failover operation. # [Output Only] Contains the details of the ongoing failover. This message is not displayed if failover is NOT in progress.
+      "failoverTrigger": "A String", # [Output Only] Indicates if failover has been triggered automatically or manually.
+      "failoverTriggerTimestamp": "A String", # [Output Only] Timestamp of the last failover trigger.
+      "lastFailoverAttempt": { # [Output Only] Contains details of the last failed failover. This field is filled only if the current failover is failing
+        "errors": { # [Output Only] Encountered errors during the last attempt to process failover.
+          "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+            {
+              "code": "A String", # [Output Only] The error type identifier for this error.
+              "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+                {
+                  "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+                    "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+                    "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                      "a_key": "A String",
+                    },
+                    "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+                  },
+                  "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+                    "links": [ # URL(s) pointing to additional information on handling the current error.
+                      { # Describes a URL link.
+                        "description": "A String", # Describes what the link offers.
+                        "url": "A String", # The URL of the link.
+                      },
+                    ],
+                  },
+                  "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+                    "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+                    "message": "A String", # The localized error message in the above locale.
+                  },
+                  "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+                    "dimensions": { # The map holding related quota dimensions.
+                      "a_key": "A String",
+                    },
+                    "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+                    "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+                    "limitName": "A String", # The name of the quota limit.
+                    "metricName": "A String", # The Compute Engine quota metric name.
+                    "rolloutStatus": "A String", # Rollout status of the future quota limit.
+                  },
+                },
+              ],
+              "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+              "message": "A String", # [Output Only] An optional, human-readable error message.
+            },
+          ],
+        },
+        "timestamp": "A String", # [Output Only] Show timestamp only if there is an error. RFC3339 text format.
+      },
+    },
+    "ongoingFailover": True or False, # [Output Only] Indicates if the failover is currently in-progress.
+    "primaryInstance": "A String", # [Output Only] The URL to the instance that is intended to be primary at this moment. Primary instance will be changed at the very beginning of a failover operation.
+    "primaryZone": "A String", # [Output Only] The name of the zone that is intended to be primary at this moment. Primary zone will be changed at the very beginning of a failover operation. The zone may not be operational in the middle of a failover operation.
+    "readyForFailover": True or False, # [Output Only] Indicates if the resource is ready for initiating a failover to the secondary zone.
+    "zoneStatus": { # [Output Only] Map of zone statuses. Key: name of the zone Value: ZoneStatus
+      "a_key": { # Contains the status of a specific zone.
+        "isPrimary": True or False, # [Output Only] Indicates if the zone is primary at this moment.
+        "isZoneReady": True or False, # [Output Only] Indicates if the zone is ready for initiating a failover.
+        "lastError": { # Contains details of the last failed operation. # [Output Only] This field is filled only if the current operation is failing.
+          "errors": { # [Output Only] Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+              {
+                "code": "A String", # [Output Only] The error type identifier for this error.
+                "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+                  {
+                    "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+                      "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+                      "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                        "a_key": "A String",
+                      },
+                      "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+                    },
+                    "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+                      "links": [ # URL(s) pointing to additional information on handling the current error.
+                        { # Describes a URL link.
+                          "description": "A String", # Describes what the link offers.
+                          "url": "A String", # The URL of the link.
+                        },
+                      ],
+                    },
+                    "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+                      "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+                      "message": "A String", # The localized error message in the above locale.
+                    },
+                    "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+                      "dimensions": { # The map holding related quota dimensions.
+                        "a_key": "A String",
+                      },
+                      "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+                      "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+                      "limitName": "A String", # The name of the quota limit.
+                      "metricName": "A String", # The Compute Engine quota metric name.
+                      "rolloutStatus": "A String", # Rollout status of the future quota limit.
+                    },
+                  },
+                ],
+                "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+                "message": "A String", # [Output Only] An optional, human-readable error message.
+              },
+            ],
+          },
+          "timestamp": "A String", # [Output Only] Show timestamp only if there is an error. RFC3339 text format.
+        },
+      },
+    },
+  },
+  "zoneConfigurations": { # Map of zone configurations Key: name of the zone Value: ZoneConfiguration
+    "a_key": { # Config for a zone that the HaController may use for running the VM instance.
+      "nodeAffinities": [ # A set of node affinity configurations. Refer to Configuring node affinity for more information. Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which the Instance could be scheduled. This message should be an exact copy of the Instances representation of NodeAffinity. LINT.IfChange(HaControllerNodeAffinityMixer)
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "reservationAffinity": { # Specifies the reservations that this instance can consume from. This message should be an exact copy of the Instances representation of AllocationAffinity. LINT.IfChange(HaControllerAllocationAffinityMixer) # Specifies the reservations that the instance can consume from.
+        "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples.
+        "key": "A String", # Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, specify googleapis.com/reservation-name as the key and specify the name of your reservation as its value.
+        "values": [ # Corresponds to the label values of a reservation resource. This can be either a name to a reservation in the same project or "projects/different-project/reservations/some-reservation-name" to target a shared reservation in the same zone but in a different project.
+          "A String",
+        ],
+      },
+    },
+  },
+}
+
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource. Google Compute Engine has three Operation resources: * [Global](/compute/docs/reference/rest/alpha/globalOperations) * [Regional](/compute/docs/reference/rest/alpha/regionOperations) * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations) You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses. Operations can be global, regional or zonal. - For global operations, use the `globalOperations` resource. - For regional operations, use the `regionOperations` resource. - For zonal operations, use the `zoneOperations` resource. For more information, read Global, Regional, and Zonal Resources. Note that completed Operation resources have a limited retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a `404` means the resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key). Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # [Output Only] Server-defined URL for this resource with the resource id.
+  "setCommonInstanceMetadataOperationMetadata": { # [Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key). Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # [Output Only] If state is `ABANDONED` or `FAILED`, this field is populated.
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+        },
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com` or `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+        {
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
+        },
+      ],
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
+    },
+  ],
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
+}
+
+ +
+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None) + 
Lists all HaControllers in the specified project in the specified region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  filter: string, A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.
+  pageToken: string, Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
+  returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "etag": "A String",
+  "id": "A String", # Unique identifier for the resource; defined by the server.
+  "items": [ # A list of HaControllers in the specified project and region.
+    { # HaController handles failover for a VM Instance.
+      "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+      "failoverInitiation": "A String", # Indicates how failover should be initiated.
+      "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+      "instanceName": "A String", # Name of the instance that HaController is in charge of. If not specified the HaController's resource name will be used instead. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+      "kind": "compute#HaController", # [Output Only] Type of the resource. Always compute#haController for HaControllers.
+      "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+      "region": "A String", # [Output Only] URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
+      "secondaryZoneCapacity": "A String", # Indicates the capacity guarantees in the secondary zone.
+      "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+      "selfLinkWithId": "A String", # [Output Only] Server-defined URL for this resource with the resource id.
+      "status": { # Contains information about current status of the HaController. # [Output Only] Status information for the HaController resource.
+        "failoverProgress": { # Contains information about the current failover operation. # [Output Only] Contains the details of the ongoing failover. This message is not displayed if failover is NOT in progress.
+          "failoverTrigger": "A String", # [Output Only] Indicates if failover has been triggered automatically or manually.
+          "failoverTriggerTimestamp": "A String", # [Output Only] Timestamp of the last failover trigger.
+          "lastFailoverAttempt": { # [Output Only] Contains details of the last failed failover. This field is filled only if the current failover is failing
+            "errors": { # [Output Only] Encountered errors during the last attempt to process failover.
+              "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+                {
+                  "code": "A String", # [Output Only] The error type identifier for this error.
+                  "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+                    {
+                      "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+                        "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+                        "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                          "a_key": "A String",
+                        },
+                        "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+                      },
+                      "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+                        "links": [ # URL(s) pointing to additional information on handling the current error.
+                          { # Describes a URL link.
+                            "description": "A String", # Describes what the link offers.
+                            "url": "A String", # The URL of the link.
+                          },
+                        ],
+                      },
+                      "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+                        "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+                        "message": "A String", # The localized error message in the above locale.
+                      },
+                      "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+                        "dimensions": { # The map holding related quota dimensions.
+                          "a_key": "A String",
+                        },
+                        "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+                        "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+                        "limitName": "A String", # The name of the quota limit.
+                        "metricName": "A String", # The Compute Engine quota metric name.
+                        "rolloutStatus": "A String", # Rollout status of the future quota limit.
+                      },
+                    },
+                  ],
+                  "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+                  "message": "A String", # [Output Only] An optional, human-readable error message.
+                },
+              ],
+            },
+            "timestamp": "A String", # [Output Only] Show timestamp only if there is an error. RFC3339 text format.
+          },
+        },
+        "ongoingFailover": True or False, # [Output Only] Indicates if the failover is currently in-progress.
+        "primaryInstance": "A String", # [Output Only] The URL to the instance that is intended to be primary at this moment. Primary instance will be changed at the very beginning of a failover operation.
+        "primaryZone": "A String", # [Output Only] The name of the zone that is intended to be primary at this moment. Primary zone will be changed at the very beginning of a failover operation. The zone may not be operational in the middle of a failover operation.
+        "readyForFailover": True or False, # [Output Only] Indicates if the resource is ready for initiating a failover to the secondary zone.
+        "zoneStatus": { # [Output Only] Map of zone statuses. Key: name of the zone Value: ZoneStatus
+          "a_key": { # Contains the status of a specific zone.
+            "isPrimary": True or False, # [Output Only] Indicates if the zone is primary at this moment.
+            "isZoneReady": True or False, # [Output Only] Indicates if the zone is ready for initiating a failover.
+            "lastError": { # Contains details of the last failed operation. # [Output Only] This field is filled only if the current operation is failing.
+              "errors": { # [Output Only] Encountered errors.
+                "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+                  {
+                    "code": "A String", # [Output Only] The error type identifier for this error.
+                    "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+                      {
+                        "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+                          "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+                          "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                            "a_key": "A String",
+                          },
+                          "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+                        },
+                        "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+                          "links": [ # URL(s) pointing to additional information on handling the current error.
+                            { # Describes a URL link.
+                              "description": "A String", # Describes what the link offers.
+                              "url": "A String", # The URL of the link.
+                            },
+                          ],
+                        },
+                        "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+                          "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+                          "message": "A String", # The localized error message in the above locale.
+                        },
+                        "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+                          "dimensions": { # The map holding related quota dimensions.
+                            "a_key": "A String",
+                          },
+                          "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+                          "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+                          "limitName": "A String", # The name of the quota limit.
+                          "metricName": "A String", # The Compute Engine quota metric name.
+                          "rolloutStatus": "A String", # Rollout status of the future quota limit.
+                        },
+                      },
+                    ],
+                    "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+                    "message": "A String", # [Output Only] An optional, human-readable error message.
+                  },
+                ],
+              },
+              "timestamp": "A String", # [Output Only] Show timestamp only if there is an error. RFC3339 text format.
+            },
+          },
+        },
+      },
+      "zoneConfigurations": { # Map of zone configurations Key: name of the zone Value: ZoneConfiguration
+        "a_key": { # Config for a zone that the HaController may use for running the VM instance.
+          "nodeAffinities": [ # A set of node affinity configurations. Refer to Configuring node affinity for more information. Overrides reservationAffinity.
+            { # Node Affinity: the configuration of desired nodes onto which the Instance could be scheduled. This message should be an exact copy of the Instances representation of NodeAffinity. LINT.IfChange(HaControllerNodeAffinityMixer)
+              "key": "A String", # Corresponds to the label key of Node resource.
+              "operator": "A String", # Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity.
+              "values": [ # Corresponds to the label values of Node resource.
+                "A String",
+              ],
+            },
+          ],
+          "reservationAffinity": { # Specifies the reservations that this instance can consume from. This message should be an exact copy of the Instances representation of AllocationAffinity. LINT.IfChange(HaControllerAllocationAffinityMixer) # Specifies the reservations that the instance can consume from.
+            "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples.
+            "key": "A String", # Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, specify googleapis.com/reservation-name as the key and specify the name of your reservation as its value.
+            "values": [ # Corresponds to the label values of a reservation resource. This can be either a name to a reservation in the same project or "projects/different-project/reservations/some-reservation-name" to target a shared reservation in the same zone but in a different project.
+              "A String",
+            ],
+          },
+        },
+      },
+    },
+  ],
+  "nextPageToken": "A String", # This token allows you to get the next page of results for maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
+  "selfLink": "A String", # [Output only] Server-defined URL for this resource.
+  "unreachables": [ # [Output only] Unreachable resources.
+    "A String",
+  ],
+  "warning": { # Informational warning message.
+    "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+    "data": [ # [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+      {
+        "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+        "value": "A String", # [Output Only] A warning data value corresponding to the key.
+      },
+    ],
+    "message": "A String", # [Output Only] A human-readable description of the warning code.
+  },
+}
+
+ +
+ 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(project, region, haController, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates HaController in the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  haController: string, ID of the HaController resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # HaController handles failover for a VM Instance.
+  "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+  "failoverInitiation": "A String", # Indicates how failover should be initiated.
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+  "instanceName": "A String", # Name of the instance that HaController is in charge of. If not specified the HaController's resource name will be used instead. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  "kind": "compute#HaController", # [Output Only] Type of the resource. Always compute#haController for HaControllers.
+  "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+  "region": "A String", # [Output Only] URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
+  "secondaryZoneCapacity": "A String", # Indicates the capacity guarantees in the secondary zone.
+  "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # [Output Only] Server-defined URL for this resource with the resource id.
+  "status": { # Contains information about current status of the HaController. # [Output Only] Status information for the HaController resource.
+    "failoverProgress": { # Contains information about the current failover operation. # [Output Only] Contains the details of the ongoing failover. This message is not displayed if failover is NOT in progress.
+      "failoverTrigger": "A String", # [Output Only] Indicates if failover has been triggered automatically or manually.
+      "failoverTriggerTimestamp": "A String", # [Output Only] Timestamp of the last failover trigger.
+      "lastFailoverAttempt": { # [Output Only] Contains details of the last failed failover. This field is filled only if the current failover is failing
+        "errors": { # [Output Only] Encountered errors during the last attempt to process failover.
+          "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+            {
+              "code": "A String", # [Output Only] The error type identifier for this error.
+              "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+                {
+                  "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+                    "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+                    "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                      "a_key": "A String",
+                    },
+                    "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+                  },
+                  "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+                    "links": [ # URL(s) pointing to additional information on handling the current error.
+                      { # Describes a URL link.
+                        "description": "A String", # Describes what the link offers.
+                        "url": "A String", # The URL of the link.
+                      },
+                    ],
+                  },
+                  "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+                    "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+                    "message": "A String", # The localized error message in the above locale.
+                  },
+                  "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+                    "dimensions": { # The map holding related quota dimensions.
+                      "a_key": "A String",
+                    },
+                    "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+                    "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+                    "limitName": "A String", # The name of the quota limit.
+                    "metricName": "A String", # The Compute Engine quota metric name.
+                    "rolloutStatus": "A String", # Rollout status of the future quota limit.
+                  },
+                },
+              ],
+              "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+              "message": "A String", # [Output Only] An optional, human-readable error message.
+            },
+          ],
+        },
+        "timestamp": "A String", # [Output Only] Show timestamp only if there is an error. RFC3339 text format.
+      },
+    },
+    "ongoingFailover": True or False, # [Output Only] Indicates if the failover is currently in-progress.
+    "primaryInstance": "A String", # [Output Only] The URL to the instance that is intended to be primary at this moment. Primary instance will be changed at the very beginning of a failover operation.
+    "primaryZone": "A String", # [Output Only] The name of the zone that is intended to be primary at this moment. Primary zone will be changed at the very beginning of a failover operation. The zone may not be operational in the middle of a failover operation.
+    "readyForFailover": True or False, # [Output Only] Indicates if the resource is ready for initiating a failover to the secondary zone.
+    "zoneStatus": { # [Output Only] Map of zone statuses. Key: name of the zone Value: ZoneStatus
+      "a_key": { # Contains the status of a specific zone.
+        "isPrimary": True or False, # [Output Only] Indicates if the zone is primary at this moment.
+        "isZoneReady": True or False, # [Output Only] Indicates if the zone is ready for initiating a failover.
+        "lastError": { # Contains details of the last failed operation. # [Output Only] This field is filled only if the current operation is failing.
+          "errors": { # [Output Only] Encountered errors.
+            "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+              {
+                "code": "A String", # [Output Only] The error type identifier for this error.
+                "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+                  {
+                    "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+                      "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+                      "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                        "a_key": "A String",
+                      },
+                      "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+                    },
+                    "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+                      "links": [ # URL(s) pointing to additional information on handling the current error.
+                        { # Describes a URL link.
+                          "description": "A String", # Describes what the link offers.
+                          "url": "A String", # The URL of the link.
+                        },
+                      ],
+                    },
+                    "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+                      "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+                      "message": "A String", # The localized error message in the above locale.
+                    },
+                    "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+                      "dimensions": { # The map holding related quota dimensions.
+                        "a_key": "A String",
+                      },
+                      "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+                      "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+                      "limitName": "A String", # The name of the quota limit.
+                      "metricName": "A String", # The Compute Engine quota metric name.
+                      "rolloutStatus": "A String", # Rollout status of the future quota limit.
+                    },
+                  },
+                ],
+                "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+                "message": "A String", # [Output Only] An optional, human-readable error message.
+              },
+            ],
+          },
+          "timestamp": "A String", # [Output Only] Show timestamp only if there is an error. RFC3339 text format.
+        },
+      },
+    },
+  },
+  "zoneConfigurations": { # Map of zone configurations Key: name of the zone Value: ZoneConfiguration
+    "a_key": { # Config for a zone that the HaController may use for running the VM instance.
+      "nodeAffinities": [ # A set of node affinity configurations. Refer to Configuring node affinity for more information. Overrides reservationAffinity.
+        { # Node Affinity: the configuration of desired nodes onto which the Instance could be scheduled. This message should be an exact copy of the Instances representation of NodeAffinity. LINT.IfChange(HaControllerNodeAffinityMixer)
+          "key": "A String", # Corresponds to the label key of Node resource.
+          "operator": "A String", # Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity.
+          "values": [ # Corresponds to the label values of Node resource.
+            "A String",
+          ],
+        },
+      ],
+      "reservationAffinity": { # Specifies the reservations that this instance can consume from. This message should be an exact copy of the Instances representation of AllocationAffinity. LINT.IfChange(HaControllerAllocationAffinityMixer) # Specifies the reservations that the instance can consume from.
+        "consumeReservationType": "A String", # Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples.
+        "key": "A String", # Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, specify googleapis.com/reservation-name as the key and specify the name of your reservation as its value.
+        "values": [ # Corresponds to the label values of a reservation resource. This can be either a name to a reservation in the same project or "projects/different-project/reservations/some-reservation-name" to target a shared reservation in the same zone but in a different project.
+          "A String",
+        ],
+      },
+    },
+  },
+}
+
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
+  updateMask: string, update_mask indicates fields to be updated as part of this request.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource. Google Compute Engine has three Operation resources: * [Global](/compute/docs/reference/rest/alpha/globalOperations) * [Regional](/compute/docs/reference/rest/alpha/regionOperations) * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations) You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses. Operations can be global, regional or zonal. - For global operations, use the `globalOperations` resource. - For regional operations, use the `regionOperations` resource. - For zonal operations, use the `zoneOperations` resource. For more information, read Global, Regional, and Zonal Resources. Note that completed Operation resources have a limited retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a `404` means the resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key). Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # [Output Only] Server-defined URL for this resource with the resource id.
+  "setCommonInstanceMetadataOperationMetadata": { # [Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key). Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # [Output Only] If state is `ABANDONED` or `FAILED`, this field is populated.
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+        },
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com` or `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+        {
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
+        },
+      ],
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
+    },
+  ],
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
+}
+
+ \ No newline at end of file diff --git a/docs/dyn/compute_alpha.networkProfiles.html b/docs/dyn/compute_alpha.networkProfiles.html index 1026278651f..0fce41b8035 100644 --- a/docs/dyn/compute_alpha.networkProfiles.html +++ b/docs/dyn/compute_alpha.networkProfiles.html @@ -121,6 +121,7 @@

Method Details

"allowCloudRouter": "A String", # Specifies whether cloud router creation is allowed. "allowDefaultNicAttachment": "A String", # Specifies whether default NIC attachment is allowed. "allowExternalIpAccess": "A String", # Specifies whether VMs are allowed to have external IP access on network interfaces connected to this VPC. + "allowFirewallPolicy": "A String", # Specifies whether firewall policy can be attached to the network. "allowInterconnect": "A String", # Specifies whether Cloud Interconnect creation is allowed. "allowIpForwarding": "A String", # Specifies whether IP forwarding is allowed. "allowLoadBalancing": "A String", # Specifies whether cloud load balancing is allowed. @@ -133,8 +134,12 @@

Method Details

"allowSameNetworkUnicast": "A String", # Specifies whether unicast within the same network is allowed. "allowStaticRoutes": "A String", # Specifies whether static route creation is allowed. "allowSubInterfaces": "A String", # Specifies whether sub interfaces are allowed. + "allowVpcFirewallRules": "A String", # Specifies whether VPC firewall rules can be created under the network. "allowVpcPeering": "A String", # Specifies whether VPC peering is allowed. "allowVpn": "A String", # Specifies whether VPN creation is allowed. + "firewallPolicyTypes": [ + "A String", + ], "interfaceTypes": [ # If set, limits the interface types that the network supports. If empty, all interface types are supported. "A String", ], @@ -207,6 +212,7 @@

Method Details

"allowCloudRouter": "A String", # Specifies whether cloud router creation is allowed. "allowDefaultNicAttachment": "A String", # Specifies whether default NIC attachment is allowed. "allowExternalIpAccess": "A String", # Specifies whether VMs are allowed to have external IP access on network interfaces connected to this VPC. + "allowFirewallPolicy": "A String", # Specifies whether firewall policy can be attached to the network. "allowInterconnect": "A String", # Specifies whether Cloud Interconnect creation is allowed. "allowIpForwarding": "A String", # Specifies whether IP forwarding is allowed. "allowLoadBalancing": "A String", # Specifies whether cloud load balancing is allowed. @@ -219,8 +225,12 @@

Method Details

"allowSameNetworkUnicast": "A String", # Specifies whether unicast within the same network is allowed. "allowStaticRoutes": "A String", # Specifies whether static route creation is allowed. "allowSubInterfaces": "A String", # Specifies whether sub interfaces are allowed. + "allowVpcFirewallRules": "A String", # Specifies whether VPC firewall rules can be created under the network. "allowVpcPeering": "A String", # Specifies whether VPC peering is allowed. "allowVpn": "A String", # Specifies whether VPN creation is allowed. + "firewallPolicyTypes": [ + "A String", + ], "interfaceTypes": [ # If set, limits the interface types that the network supports. If empty, all interface types are supported. "A String", ], diff --git a/docs/dyn/compute_alpha.regionBackendServices.html b/docs/dyn/compute_alpha.regionBackendServices.html index 5cffedb0c08..d1a7dcee3df 100644 --- a/docs/dyn/compute_alpha.regionBackendServices.html +++ b/docs/dyn/compute_alpha.regionBackendServices.html @@ -287,11 +287,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -883,11 +887,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -1511,11 +1519,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -2037,11 +2049,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -2579,11 +2595,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -3461,11 +3481,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. diff --git a/docs/dyn/compute_alpha.regionCommitments.html b/docs/dyn/compute_alpha.regionCommitments.html index 48442234ca4..8f8a6baee4b 100644 --- a/docs/dyn/compute_alpha.regionCommitments.html +++ b/docs/dyn/compute_alpha.regionCommitments.html @@ -166,6 +166,9 @@

Method Details

"reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -690,6 +693,9 @@

Method Details

"reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -907,6 +913,9 @@

Method Details

"reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -1254,6 +1263,9 @@

Method Details

"reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -1533,6 +1545,9 @@

Method Details

"reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -1848,6 +1863,9 @@

Method Details

"reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. diff --git a/docs/dyn/compute_alpha.regionHealthAggregationPolicies.html b/docs/dyn/compute_alpha.regionHealthAggregationPolicies.html index ff86b3543f1..a01038edc59 100644 --- a/docs/dyn/compute_alpha.regionHealthAggregationPolicies.html +++ b/docs/dyn/compute_alpha.regionHealthAggregationPolicies.html @@ -74,6 +74,12 @@

Compute Engine API . regionHealthAggregationPolicies

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all HealthAggregationPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`.

+

+ aggregatedList_next()

+

Retrieves the next page of results.

close()

Close httplib2 connections.

@@ -99,6 +105,92 @@

Instance Methods

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

Returns permissions that a caller has on the specified resource.

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None) + 
Retrieves the list of all HealthAggregationPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`.
+
+Args:
+  project: string, Name of the project scoping this request. (required)
+  filter: string, A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.
+  includeAllScopes: boolean, Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.
+  maxResults: integer, The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
+  orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.
+  pageToken: string, Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
+  returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.
+  serviceProjectNumber: string, The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Contains a list of HealthAggregationPoliciesScopedList.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of HealthAggregationPoliciesScopedList resources.
+    "a_key": { # Name of the scope containing this set of HealthAggregationPolicies.
+      "healthAggregationPolicies": [ # A list of HealthAggregationPolicys contained in this scope.
+        { # Represents a health aggregation policy. A health aggregation policy resource defines a policy to aggregate health. For more information, see Health checks overview.
+          "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+          "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
+          "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a HealthAggregationPolicy. An up-to-date fingerprint must be provided in order to patch the HealthAggregationPolicy; Otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the HealthAggregationPolicy.
+          "healthyPercentThreshold": 42, # Can only be set if the policyType field is BACKEND_SERVICE_POLICY. Specifies the threshold (as a percentage) of healthy endpoints required in order to consider the aggregated health result HEALTHY. Defaults to 60. Must be in range [0, 100]. Not applicable if the policyType field is DNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional, and will be set to the default if unspecified. Note that both this threshold and minHealthyThreshold must be satisfied in order for HEALTHY to be the aggregated result. "Endpoints" refers to network endpoints within a Network Endpoint Group or instances within an Instance Group.
+          "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
+          "kind": "compute#healthAggregationPolicy", # [Output Only] Type of the resource. Always compute#healthAggregationPolicy for health aggregation policies.
+          "minHealthyThreshold": 42, # Can only be set if the policyType field is BACKEND_SERVICE_POLICY. Specifies the minimum number of healthy endpoints required in order to consider the aggregated health result HEALTHY. Defaults to 1. Must be positive. Not applicable if the policyType field is DNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional, and will be set to the default if unspecified. Note that both this threshold and healthyPercentThreshold must be satisfied in order for HEALTHY to be the aggregated result. "Endpoints" refers to network endpoints within a Network Endpoint Group or instances within an Instance Group.
+          "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
+          "policyType": "A String", # Specifies the type of the healthAggregationPolicy. The only allowed value for global resources is DNS_PUBLIC_IP_POLICY. The only allowed value for regional resources is BACKEND_SERVICE_POLICY. Must be specified when the healthAggregationPolicy is created, and cannot be mutated.
+          "region": "A String", # [Output Only] URL of the region where the health aggregation policy resides. This field applies only to the regional resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
+          "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+          "selfLinkWithId": "A String", # [Output Only] Server-defined URL with id for the resource.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of health aggregation policies when the list is empty.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+          {
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+          },
+        ],
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+      },
+    },
+  },
+  "kind": "compute#healthAggregationPolicyAggregatedList", # Type of resource.
+  "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
+  "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
+  "unreachables": [ # [Output Only] Unreachable resources.
+    "A String",
+  ],
+  "warning": { # [Output Only] Informational warning message.
+    "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+    "data": [ # [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+      {
+        "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+        "value": "A String", # [Output Only] A warning data value corresponding to the key.
+      },
+    ],
+    "message": "A String", # [Output Only] A human-readable description of the warning code.
+  },
+}
+
+ +
+ aggregatedList_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.
+
+
+
close() 
Close httplib2 connections.
diff --git a/docs/dyn/compute_alpha.regionMultiMigs.html b/docs/dyn/compute_alpha.regionMultiMigs.html index c464743ee1f..9e6e5f4f262 100644 --- a/docs/dyn/compute_alpha.regionMultiMigs.html +++ b/docs/dyn/compute_alpha.regionMultiMigs.html @@ -252,6 +252,57 @@

Method Details

}, "selfLink": "A String", # [Output only] Server-defined URL for the resource. "status": { + "appliedAcceleratorTopologies": [ # [Output Only] The accelerator topology applied to this multi-MIG. Currently only one accelerator topology is supported. + { + "acceleratorTopology": "A String", # [Output Only] Topology in the format of: "16x16", "4x4x4", etc. The value is the same as configured in the WorkloadPolicy. + "acceleratorTopologyState": "A String", # [Output Only] The state of the accelerator topology. + "acceleratorTopologyStateLastCheck": { # [Output Only] The result of the latest accelerator topology state check. + "error": { # [Output Only] Encountered errors on the last state check. + "errors": [ # [Output Only] The array of errors encountered while processing this operation. + { + "code": "A String", # [Output Only] The error type identifier for this error. + "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED. + { + "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } } + "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com". + "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request. + "a_key": "A String", + }, + "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. + }, + "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit. + "links": [ # URL(s) pointing to additional information on handling the current error. + { # Describes a URL link. + "description": "A String", # Describes what the link offers. + "url": "A String", # The URL of the link. + }, + ], + }, + "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error. + "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX" + "message": "A String", # The localized error message in the above locale. + }, + "quotaInfo": { # Additional details for quota exceeded error for resource quota. + "dimensions": { # The map holding related quota dimensions. + "a_key": "A String", + }, + "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric. + "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric. + "limitName": "A String", # The name of the quota limit. + "metricName": "A String", # The Compute Engine quota metric name. + "rolloutStatus": "A String", # Rollout status of the future quota limit. + }, + }, + ], + "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional. + "message": "A String", # [Output Only] An optional, human-readable error message. + }, + ], + }, + "timestamp": "A String", # [Output Only] Timestamp is shown only if there is an error. The field has // RFC3339 // text format. + }, + }, + ], "memberInstanceGroupManagers": [ "A String", ], @@ -282,6 +333,57 @@

Method Details

}, "selfLink": "A String", # [Output only] Server-defined URL for the resource. "status": { + "appliedAcceleratorTopologies": [ # [Output Only] The accelerator topology applied to this multi-MIG. Currently only one accelerator topology is supported. + { + "acceleratorTopology": "A String", # [Output Only] Topology in the format of: "16x16", "4x4x4", etc. The value is the same as configured in the WorkloadPolicy. + "acceleratorTopologyState": "A String", # [Output Only] The state of the accelerator topology. + "acceleratorTopologyStateLastCheck": { # [Output Only] The result of the latest accelerator topology state check. + "error": { # [Output Only] Encountered errors on the last state check. + "errors": [ # [Output Only] The array of errors encountered while processing this operation. + { + "code": "A String", # [Output Only] The error type identifier for this error. + "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED. + { + "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } } + "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com". + "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request. + "a_key": "A String", + }, + "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. + }, + "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit. + "links": [ # URL(s) pointing to additional information on handling the current error. + { # Describes a URL link. + "description": "A String", # Describes what the link offers. + "url": "A String", # The URL of the link. + }, + ], + }, + "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error. + "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX" + "message": "A String", # The localized error message in the above locale. + }, + "quotaInfo": { # Additional details for quota exceeded error for resource quota. + "dimensions": { # The map holding related quota dimensions. + "a_key": "A String", + }, + "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric. + "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric. + "limitName": "A String", # The name of the quota limit. + "metricName": "A String", # The Compute Engine quota metric name. + "rolloutStatus": "A String", # Rollout status of the future quota limit. + }, + }, + ], + "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional. + "message": "A String", # [Output Only] An optional, human-readable error message. + }, + ], + }, + "timestamp": "A String", # [Output Only] Timestamp is shown only if there is an error. The field has // RFC3339 // text format. + }, + }, + ], "memberInstanceGroupManagers": [ "A String", ], @@ -442,6 +544,57 @@

Method Details

}, "selfLink": "A String", # [Output only] Server-defined URL for the resource. "status": { + "appliedAcceleratorTopologies": [ # [Output Only] The accelerator topology applied to this multi-MIG. Currently only one accelerator topology is supported. + { + "acceleratorTopology": "A String", # [Output Only] Topology in the format of: "16x16", "4x4x4", etc. The value is the same as configured in the WorkloadPolicy. + "acceleratorTopologyState": "A String", # [Output Only] The state of the accelerator topology. + "acceleratorTopologyStateLastCheck": { # [Output Only] The result of the latest accelerator topology state check. + "error": { # [Output Only] Encountered errors on the last state check. + "errors": [ # [Output Only] The array of errors encountered while processing this operation. + { + "code": "A String", # [Output Only] The error type identifier for this error. + "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED. + { + "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } } + "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com". + "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request. + "a_key": "A String", + }, + "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. + }, + "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit. + "links": [ # URL(s) pointing to additional information on handling the current error. + { # Describes a URL link. + "description": "A String", # Describes what the link offers. + "url": "A String", # The URL of the link. + }, + ], + }, + "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error. + "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX" + "message": "A String", # The localized error message in the above locale. + }, + "quotaInfo": { # Additional details for quota exceeded error for resource quota. + "dimensions": { # The map holding related quota dimensions. + "a_key": "A String", + }, + "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric. + "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric. + "limitName": "A String", # The name of the quota limit. + "metricName": "A String", # The Compute Engine quota metric name. + "rolloutStatus": "A String", # Rollout status of the future quota limit. + }, + }, + ], + "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional. + "message": "A String", # [Output Only] An optional, human-readable error message. + }, + ], + }, + "timestamp": "A String", # [Output Only] Timestamp is shown only if there is an error. The field has // RFC3339 // text format. + }, + }, + ], "memberInstanceGroupManagers": [ "A String", ], diff --git a/docs/dyn/compute_alpha.reservationBlocks.html b/docs/dyn/compute_alpha.reservationBlocks.html index 26083a218a6..99904fc00c9 100644 --- a/docs/dyn/compute_alpha.reservationBlocks.html +++ b/docs/dyn/compute_alpha.reservationBlocks.html @@ -128,6 +128,7 @@

Method Details

}, "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server. "inUseCount": 42, # [Output Only] The number of instances that are currently in use on this reservation block. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. "kind": "compute#reservationBlock", # [Output Only] Type of the resource. Always compute#reservationBlock for reservation blocks. "locationPrefix": "A String", # [Output Only] Obfuscated location where this reservation block physically resides in format /CCCC/GGGG. This matches the tripod specified in the VM topology information. Example: /USEAB1/0101/ is the location prefix in /USEAB1/0101/031/003 "name": "A String", # [Output Only] The name of this reservation block generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? @@ -216,6 +217,7 @@

Method Details

}, "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server. "inUseCount": 42, # [Output Only] The number of instances that are currently in use on this reservation block. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. "kind": "compute#reservationBlock", # [Output Only] Type of the resource. Always compute#reservationBlock for reservation blocks. "locationPrefix": "A String", # [Output Only] Obfuscated location where this reservation block physically resides in format /CCCC/GGGG. This matches the tripod specified in the VM topology information. Example: /USEAB1/0101/ is the location prefix in /USEAB1/0101/031/003 "name": "A String", # [Output Only] The name of this reservation block generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? diff --git a/docs/dyn/compute_alpha.reservationSubBlocks.html b/docs/dyn/compute_alpha.reservationSubBlocks.html index c607e314e7f..ae612d70cae 100644 --- a/docs/dyn/compute_alpha.reservationSubBlocks.html +++ b/docs/dyn/compute_alpha.reservationSubBlocks.html @@ -89,6 +89,9 @@

Instance Methods

performMaintenance(project, zone, parentName, reservationSubBlock, requestId=None, x__xgafv=None)

Allows customers to perform maintenance on a reservation subBlock

+

+ reportFaulty(project, zone, parentName, reservationSubBlock, body=None, requestId=None, x__xgafv=None)

+

Allows customers to report a faulty subBlock.

Method Details

close() @@ -125,6 +128,7 @@

Method Details

}, "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server. "inUseCount": 42, # [Output Only] The number of instances that are currently in use on this reservation subBlock. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. "kind": "compute#reservationSubBlock", # [Output Only] Type of the resource. Always compute#reservationSubBlock for reservation subBlocks. "name": "A String", # [Output Only] The name of this reservation subBlock generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? "physicalTopology": { # [Output Only] The physical topology of the reservation subBlock. @@ -203,6 +207,7 @@

Method Details

}, "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server. "inUseCount": 42, # [Output Only] The number of instances that are currently in use on this reservation subBlock. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. "kind": "compute#reservationSubBlock", # [Output Only] Type of the resource. Always compute#reservationSubBlock for reservation subBlocks. "name": "A String", # [Output Only] The name of this reservation subBlock generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? "physicalTopology": { # [Output Only] The physical topology of the reservation subBlock. @@ -400,4 +405,145 @@

Method Details

}
+
+ reportFaulty(project, zone, parentName, reservationSubBlock, body=None, requestId=None, x__xgafv=None) + 
Allows customers to report a faulty subBlock.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
+  parentName: string, The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (required)
+  reservationSubBlock: string, The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "disruptionSchedule": "A String", # The disruption schedule for the subBlock.
+  "failureComponent": "A String", # The component that experienced the fault.
+  "faultReasons": [ # The reasons for the fault experienced with the subBlock.
+    { # The reason for the fault experienced with the subBlock.
+      "behavior": "A String", # The behavior of the fault experienced with the subBlock.
+      "description": "A String", # The description of the fault experienced with the subBlock.
+    },
+  ],
+}
+
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource. Google Compute Engine has three Operation resources: * [Global](/compute/docs/reference/rest/alpha/globalOperations) * [Regional](/compute/docs/reference/rest/alpha/regionOperations) * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations) You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses. Operations can be global, regional or zonal. - For global operations, use the `globalOperations` resource. - For regional operations, use the `regionOperations` resource. - For zonal operations, use the `zoneOperations` resource. For more information, read Global, Regional, and Zonal Resources. Note that completed Operation resources have a limited retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a `404` means the resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key). Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # [Output Only] Server-defined URL for this resource with the resource id.
+  "setCommonInstanceMetadataOperationMetadata": { # [Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key). Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # [Output Only] If state is `ABANDONED` or `FAILED`, this field is populated.
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+        },
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com` or `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+        {
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
+        },
+      ],
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
+    },
+  ],
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
+}
+
+ \ No newline at end of file diff --git a/docs/dyn/compute_alpha.reservations.html b/docs/dyn/compute_alpha.reservations.html index fd3ef2f31c7..941804f3c79 100644 --- a/docs/dyn/compute_alpha.reservations.html +++ b/docs/dyn/compute_alpha.reservations.html @@ -148,6 +148,9 @@

Method Details

"reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -484,6 +487,9 @@

Method Details

"reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -689,6 +695,9 @@

Method Details

"reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -974,6 +983,9 @@

Method Details

"reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. @@ -1558,6 +1570,9 @@

Method Details

"reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. + "hostCount": 42, # Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected. + "inUseHostCount": 42, # Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. + "inUseInstanceCount": 42, # Number of instances currently in use in this reservation. "inUseResources": [ # [Output only] List of resources currently in use. { "accelerator": { # Properties of accelerator resources in this reservation. diff --git a/docs/dyn/compute_alpha.resourcePolicies.html b/docs/dyn/compute_alpha.resourcePolicies.html index a54237138cd..95d489d120f 100644 --- a/docs/dyn/compute_alpha.resourcePolicies.html +++ b/docs/dyn/compute_alpha.resourcePolicies.html @@ -228,10 +228,10 @@

Method Details

}, }, }, - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, }, ], @@ -517,10 +517,10 @@

Method Details

}, }, }, - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, }
@@ -675,10 +675,10 @@

Method Details

}, }, }, - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, } @@ -914,10 +914,10 @@

Method Details

}, }, }, - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, }, ], @@ -1052,10 +1052,10 @@

Method Details

}, }, }, - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, } diff --git a/docs/dyn/compute_alpha.targetVpnGateways.html b/docs/dyn/compute_alpha.targetVpnGateways.html index bbc05a591e7..b83f18cb3a3 100644 --- a/docs/dyn/compute_alpha.targetVpnGateways.html +++ b/docs/dyn/compute_alpha.targetVpnGateways.html @@ -145,6 +145,11 @@

Method Details

}, "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the target VPN gateway resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "status": "A String", # [Output Only] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING. @@ -359,6 +364,11 @@

Method Details

}, "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the target VPN gateway resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "status": "A String", # [Output Only] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING. @@ -392,6 +402,11 @@

Method Details

}, "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the target VPN gateway resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "status": "A String", # [Output Only] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING. @@ -555,6 +570,11 @@

Method Details

}, "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the target VPN gateway resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "status": "A String", # [Output Only] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING. diff --git a/docs/dyn/compute_alpha.vpnGateways.html b/docs/dyn/compute_alpha.vpnGateways.html index aa161d6a468..d3f07e95dc1 100644 --- a/docs/dyn/compute_alpha.vpnGateways.html +++ b/docs/dyn/compute_alpha.vpnGateways.html @@ -146,6 +146,11 @@

Method Details

}, "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the VPN gateway resides. "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "stackType": "A String", # The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not specified, IPV4_ONLY is used if the gateway IP version is IPV4, or IPV4_IPV6 if the gateway IP version is IPV6. @@ -363,6 +368,11 @@

Method Details

}, "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the VPN gateway resides. "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "stackType": "A String", # The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not specified, IPV4_ONLY is used if the gateway IP version is IPV4, or IPV4_IPV6 if the gateway IP version is IPV6. @@ -438,6 +448,11 @@

Method Details

}, "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the VPN gateway resides. "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "stackType": "A String", # The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not specified, IPV4_ONLY is used if the gateway IP version is IPV4, or IPV4_IPV6 if the gateway IP version is IPV6. @@ -604,6 +619,11 @@

Method Details

}, "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the VPN gateway resides. "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "stackType": "A String", # The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not specified, IPV4_ONLY is used if the gateway IP version is IPV4, or IPV4_IPV6 if the gateway IP version is IPV6. diff --git a/docs/dyn/compute_alpha.vpnTunnels.html b/docs/dyn/compute_alpha.vpnTunnels.html index ec99d34024a..363cd2cbe24 100644 --- a/docs/dyn/compute_alpha.vpnTunnels.html +++ b/docs/dyn/compute_alpha.vpnTunnels.html @@ -173,6 +173,11 @@

Method Details

"A String", ], "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "peerExternalGateway": "A String", # URL of the peer side external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field is exclusive with the field peerGcpGateway. "peerExternalGatewayInterface": 42, # The interface ID of the external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the external VPN gateway redundancy type. "peerGcpGateway": "A String", # URL of the peer side HA VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field can be used when creating highly available VPN from VPC network to VPC network, the field is exclusive with the field peerExternalGateway. If provided, the VPN tunnel will automatically use the same vpnGatewayInterface ID in the peer Google Cloud VPN gateway. @@ -425,6 +430,11 @@

Method Details

"A String", ], "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "peerExternalGateway": "A String", # URL of the peer side external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field is exclusive with the field peerGcpGateway. "peerExternalGatewayInterface": 42, # The interface ID of the external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the external VPN gateway redundancy type. "peerGcpGateway": "A String", # URL of the peer side HA VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field can be used when creating highly available VPN from VPC network to VPC network, the field is exclusive with the field peerExternalGateway. If provided, the VPN tunnel will automatically use the same vpnGatewayInterface ID in the peer Google Cloud VPN gateway. @@ -496,6 +506,11 @@

Method Details

"A String", ], "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "peerExternalGateway": "A String", # URL of the peer side external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field is exclusive with the field peerGcpGateway. "peerExternalGatewayInterface": 42, # The interface ID of the external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the external VPN gateway redundancy type. "peerGcpGateway": "A String", # URL of the peer side HA VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field can be used when creating highly available VPN from VPC network to VPC network, the field is exclusive with the field peerExternalGateway. If provided, the VPN tunnel will automatically use the same vpnGatewayInterface ID in the peer Google Cloud VPN gateway. @@ -697,6 +712,11 @@

Method Details

"A String", ], "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "peerExternalGateway": "A String", # URL of the peer side external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field is exclusive with the field peerGcpGateway. "peerExternalGatewayInterface": 42, # The interface ID of the external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the external VPN gateway redundancy type. "peerGcpGateway": "A String", # URL of the peer side HA VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field can be used when creating highly available VPN from VPC network to VPC network, the field is exclusive with the field peerExternalGateway. If provided, the VPN tunnel will automatically use the same vpnGatewayInterface ID in the peer Google Cloud VPN gateway. diff --git a/docs/dyn/compute_beta.backendServices.html b/docs/dyn/compute_beta.backendServices.html index 523c2a4044e..7e9c9f8099c 100644 --- a/docs/dyn/compute_beta.backendServices.html +++ b/docs/dyn/compute_beta.backendServices.html @@ -315,11 +315,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -893,11 +897,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -1534,11 +1542,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -1937,11 +1949,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -2239,11 +2255,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -2557,11 +2577,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -3341,11 +3365,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. diff --git a/docs/dyn/compute_beta.instanceGroupManagers.html b/docs/dyn/compute_beta.instanceGroupManagers.html index c13c1528dd5..7ede2eaab06 100644 --- a/docs/dyn/compute_beta.instanceGroupManagers.html +++ b/docs/dyn/compute_beta.instanceGroupManagers.html @@ -2362,6 +2362,9 @@

Method Details

"machineType": "A String", # The machine type to be used for this instance. "provisioningModel": "A String", # The provisioning model to be used for this instance. }, + "scheduling": { # [Output Only] Information about the termination timestamp of the instance, if applicable. + "terminationTimestamp": "A String", # [Output Only] The timestamp at which the managed instance will be terminated. This is in RFC3339 text format. + }, "targetStatus": "A String", # [Output Only] The eventual status of the instance. The instance group manager will not be identified as stable till each managed instance reaches its targetStatus. "version": { # [Output Only] Intended version of this instance. "instanceTemplate": "A String", # [Output Only] The intended template of the instance. This field is empty when current_action is one of { DELETING, ABANDONING }. diff --git a/docs/dyn/compute_beta.regionBackendServices.html b/docs/dyn/compute_beta.regionBackendServices.html index 979511b5ae0..7630f6cebc5 100644 --- a/docs/dyn/compute_beta.regionBackendServices.html +++ b/docs/dyn/compute_beta.regionBackendServices.html @@ -285,11 +285,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -658,11 +662,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -1062,11 +1070,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -1365,11 +1377,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -1684,11 +1700,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. @@ -2341,11 +2361,15 @@

Method Details

"maxConnections": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerEndpoint": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. "maxConnectionsPerInstance": 42, # Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + "maxInFlightRequests": 42, # Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerEndpoint": 42, # Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION. + "maxInFlightRequestsPerInstance": 42, # Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION. "maxRate": 42, # Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerEndpoint": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxRatePerInstance": 3.14, # Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. "maxUtilization": 3.14, # Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. "preference": "A String", # This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + "trafficDuration": "A String", }, ], "cdnPolicy": { # Message containing Cloud CDN configuration for a backend service. # Cloud CDN configuration for this BackendService. Only available for specified load balancer types. diff --git a/docs/dyn/compute_beta.regionCommitments.html b/docs/dyn/compute_beta.regionCommitments.html index cd33c84c480..5763d0df119 100644 --- a/docs/dyn/compute_beta.regionCommitments.html +++ b/docs/dyn/compute_beta.regionCommitments.html @@ -156,6 +156,9 @@

Method Details

"region": "A String", # [Output Only] URL of the region where the commitment and committed resources are located. "reservations": [ # The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead. { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations. + "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. + }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. "inUseResources": [ # [Output only] List of resources currently in use. { @@ -388,6 +391,9 @@

Method Details

"region": "A String", # [Output Only] URL of the region where the commitment and committed resources are located. "reservations": [ # The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead. { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations. + "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. + }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. "inUseResources": [ # [Output only] List of resources currently in use. { @@ -565,6 +571,9 @@

Method Details

"region": "A String", # [Output Only] URL of the region where the commitment and committed resources are located. "reservations": [ # The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead. { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations. + "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. + }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. "inUseResources": [ # [Output only] List of resources currently in use. { @@ -871,6 +880,9 @@

Method Details

"region": "A String", # [Output Only] URL of the region where the commitment and committed resources are located. "reservations": [ # The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead. { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations. + "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. + }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. "inUseResources": [ # [Output only] List of resources currently in use. { @@ -1110,6 +1122,9 @@

Method Details

"region": "A String", # [Output Only] URL of the region where the commitment and committed resources are located. "reservations": [ # The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead. { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations. + "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. + }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. "inUseResources": [ # [Output only] List of resources currently in use. { @@ -1384,6 +1399,9 @@

Method Details

{ "reservations": [ # A list of two reservations to transfer GPUs and Local SSD disks between. { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations. + "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. + }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. "inUseResources": [ # [Output only] List of resources currently in use. { diff --git a/docs/dyn/compute_beta.regionInstanceGroupManagers.html b/docs/dyn/compute_beta.regionInstanceGroupManagers.html index f82ba0dc260..74d754afe72 100644 --- a/docs/dyn/compute_beta.regionInstanceGroupManagers.html +++ b/docs/dyn/compute_beta.regionInstanceGroupManagers.html @@ -2062,6 +2062,9 @@

Method Details

"machineType": "A String", # The machine type to be used for this instance. "provisioningModel": "A String", # The provisioning model to be used for this instance. }, + "scheduling": { # [Output Only] Information about the termination timestamp of the instance, if applicable. + "terminationTimestamp": "A String", # [Output Only] The timestamp at which the managed instance will be terminated. This is in RFC3339 text format. + }, "targetStatus": "A String", # [Output Only] The eventual status of the instance. The instance group manager will not be identified as stable till each managed instance reaches its targetStatus. "version": { # [Output Only] Intended version of this instance. "instanceTemplate": "A String", # [Output Only] The intended template of the instance. This field is empty when current_action is one of { DELETING, ABANDONING }. diff --git a/docs/dyn/compute_beta.reservations.html b/docs/dyn/compute_beta.reservations.html index 1d20eac3a7e..c25ed42bb9b 100644 --- a/docs/dyn/compute_beta.reservations.html +++ b/docs/dyn/compute_beta.reservations.html @@ -144,6 +144,9 @@

Method Details

"a_key": { # Name of the scope containing this set of reservations. "reservations": [ # A list of reservations contained in this scope. { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations. + "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. + }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. "inUseResources": [ # [Output only] List of resources currently in use. { @@ -459,6 +462,9 @@

Method Details

An object of the form: { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations. + "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. + }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. "inUseResources": [ # [Output only] List of resources currently in use. { @@ -644,6 +650,9 @@

Method Details

The object takes the form of: { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations. + "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. + }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. "inUseResources": [ # [Output only] List of resources currently in use. { @@ -908,6 +917,9 @@

Method Details

"id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server. "items": [ # [Output Only] A list of Allocation resources. { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations. + "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. + }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. "inUseResources": [ # [Output only] List of resources currently in use. { @@ -1470,6 +1482,9 @@

Method Details

The object takes the form of: { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations. + "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation. + }, "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility. "inUseResources": [ # [Output only] List of resources currently in use. { diff --git a/docs/dyn/compute_beta.resourcePolicies.html b/docs/dyn/compute_beta.resourcePolicies.html index 2bc5f9ba967..2aea8356608 100644 --- a/docs/dyn/compute_beta.resourcePolicies.html +++ b/docs/dyn/compute_beta.resourcePolicies.html @@ -213,10 +213,10 @@

Method Details

}, }, "status": "A String", # [Output Only] The status of resource policy creation. - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, }, ], @@ -486,10 +486,10 @@

Method Details

}, }, "status": "A String", # [Output Only] The status of resource policy creation. - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, }
@@ -629,10 +629,10 @@

Method Details

}, }, "status": "A String", # [Output Only] The status of resource policy creation. - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, } @@ -852,10 +852,10 @@

Method Details

}, }, "status": "A String", # [Output Only] The status of resource policy creation. - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, }, ], @@ -975,10 +975,10 @@

Method Details

}, }, "status": "A String", # [Output Only] The status of resource policy creation. - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, } diff --git a/docs/dyn/compute_v1.backendBuckets.html b/docs/dyn/compute_v1.backendBuckets.html index 735651077b5..de365733867 100644 --- a/docs/dyn/compute_v1.backendBuckets.html +++ b/docs/dyn/compute_v1.backendBuckets.html @@ -564,6 +564,11 @@

Method Details

"kind": "compute#backendBucket", # Type of the resource. "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both. "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + "params": { # Additional Backend Bucket parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "usedBy": [ # [Output Only] List of resources referencing that backend bucket. { @@ -677,6 +682,11 @@

Method Details

"kind": "compute#backendBucket", # Type of the resource. "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both. "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + "params": { # Additional Backend Bucket parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "usedBy": [ # [Output Only] List of resources referencing that backend bucket. { @@ -870,6 +880,11 @@

Method Details

"kind": "compute#backendBucket", # Type of the resource. "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both. "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + "params": { # Additional Backend Bucket parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "usedBy": [ # [Output Only] List of resources referencing that backend bucket. { @@ -964,6 +979,11 @@

Method Details

"kind": "compute#backendBucket", # Type of the resource. "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both. "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + "params": { # Additional Backend Bucket parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "usedBy": [ # [Output Only] List of resources referencing that backend bucket. { @@ -1407,6 +1427,11 @@

Method Details

"kind": "compute#backendBucket", # Type of the resource. "loadBalancingScheme": "A String", # The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both. "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + "params": { # Additional Backend Bucket parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "selfLink": "A String", # [Output Only] Server-defined URL for the resource. "usedBy": [ # [Output Only] List of resources referencing that backend bucket. { diff --git a/docs/dyn/compute_v1.backendServices.html b/docs/dyn/compute_v1.backendServices.html index 64816e96f2b..8a4c449f220 100644 --- a/docs/dyn/compute_v1.backendServices.html +++ b/docs/dyn/compute_v1.backendServices.html @@ -483,6 +483,11 @@

Method Details

"successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG. "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG. }, + "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port. "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name. "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. @@ -1039,6 +1044,11 @@

Method Details

"successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG. "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG. }, + "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port. "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name. "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. @@ -1387,6 +1397,11 @@

Method Details

"successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG. "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG. }, + "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port. "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name. "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. @@ -1768,6 +1783,11 @@

Method Details

"successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG. "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG. }, + "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port. "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name. "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. @@ -2048,6 +2068,11 @@

Method Details

"successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG. "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG. }, + "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port. "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name. "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. @@ -2344,6 +2369,11 @@

Method Details

"successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG. "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG. }, + "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port. "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name. "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. @@ -3106,6 +3136,11 @@

Method Details

"successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG. "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG. }, + "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + "a_key": "A String", + }, + }, "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port. "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name. "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. diff --git a/docs/dyn/compute_v1.interconnects.html b/docs/dyn/compute_v1.interconnects.html index 7b04893cce4..77dda063684 100644 --- a/docs/dyn/compute_v1.interconnects.html +++ b/docs/dyn/compute_v1.interconnects.html @@ -250,7 +250,27 @@

Method Details

An object of the form: { # Represents an Interconnect resource. An Interconnect resource is a dedicated connection between the Google Cloud network and your on-premises network. For more information, read the Dedicated Interconnect Overview. + "aaiEnabled": True or False, # Enable or disable the application awareness feature on this Cloud Interconnect. "adminEnabled": True or False, # Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + "applicationAwareInterconnect": { # Configuration information for application awareness on this Cloud Interconnect. # Configuration information for application awareness on this Cloud Interconnect. + "bandwidthPercentagePolicy": { + "bandwidthPercentages": [ # Specify bandwidth percentages for various traffic classes for queuing type Bandwidth Percent. + { # Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified. + "percentage": 42, # Bandwidth percentage for a specific traffic class. + "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified. + }, + ], + }, + "profileDescription": "A String", # Description for the application awareness profile on this Cloud Interconnect. + "shapeAveragePercentages": [ # Optional field to specify a list of shape average percentages to be applied in conjunction with StrictPriorityPolicy or BandwidthPercentagePolicy. + { # Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified. + "percentage": 42, # Bandwidth percentage for a specific traffic class. + "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified. + }, + ], + "strictPriorityPolicy": { # Specify configuration for StrictPriorityPolicy. + }, + }, "availableFeatures": [ # [Output only] List of features available for this Interconnect connection, which can take one of the following values: - IF_MACSEC If present then the Interconnect connection is provisioned on MACsec capable hardware ports. If not present then the Interconnect connection is provisioned on non-MACsec capable ports and MACsec isn't supported and enabling MACsec fails. "A String", ], @@ -421,7 +441,27 @@

Method Details

The object takes the form of: { # Represents an Interconnect resource. An Interconnect resource is a dedicated connection between the Google Cloud network and your on-premises network. For more information, read the Dedicated Interconnect Overview. + "aaiEnabled": True or False, # Enable or disable the application awareness feature on this Cloud Interconnect. "adminEnabled": True or False, # Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + "applicationAwareInterconnect": { # Configuration information for application awareness on this Cloud Interconnect. # Configuration information for application awareness on this Cloud Interconnect. + "bandwidthPercentagePolicy": { + "bandwidthPercentages": [ # Specify bandwidth percentages for various traffic classes for queuing type Bandwidth Percent. + { # Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified. + "percentage": 42, # Bandwidth percentage for a specific traffic class. + "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified. + }, + ], + }, + "profileDescription": "A String", # Description for the application awareness profile on this Cloud Interconnect. + "shapeAveragePercentages": [ # Optional field to specify a list of shape average percentages to be applied in conjunction with StrictPriorityPolicy or BandwidthPercentagePolicy. + { # Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified. + "percentage": 42, # Bandwidth percentage for a specific traffic class. + "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified. + }, + ], + "strictPriorityPolicy": { # Specify configuration for StrictPriorityPolicy. + }, + }, "availableFeatures": [ # [Output only] List of features available for this Interconnect connection, which can take one of the following values: - IF_MACSEC If present then the Interconnect connection is provisioned on MACsec capable hardware ports. If not present then the Interconnect connection is provisioned on non-MACsec capable ports and MACsec isn't supported and enabling MACsec fails. "A String", ], @@ -631,7 +671,27 @@

Method Details

"id": "A String", # [Output Only] Unique identifier for the resource; defined by the server. "items": [ # A list of Interconnect resources. { # Represents an Interconnect resource. An Interconnect resource is a dedicated connection between the Google Cloud network and your on-premises network. For more information, read the Dedicated Interconnect Overview. + "aaiEnabled": True or False, # Enable or disable the application awareness feature on this Cloud Interconnect. "adminEnabled": True or False, # Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + "applicationAwareInterconnect": { # Configuration information for application awareness on this Cloud Interconnect. # Configuration information for application awareness on this Cloud Interconnect. + "bandwidthPercentagePolicy": { + "bandwidthPercentages": [ # Specify bandwidth percentages for various traffic classes for queuing type Bandwidth Percent. + { # Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified. + "percentage": 42, # Bandwidth percentage for a specific traffic class. + "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified. + }, + ], + }, + "profileDescription": "A String", # Description for the application awareness profile on this Cloud Interconnect. + "shapeAveragePercentages": [ # Optional field to specify a list of shape average percentages to be applied in conjunction with StrictPriorityPolicy or BandwidthPercentagePolicy. + { # Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified. + "percentage": 42, # Bandwidth percentage for a specific traffic class. + "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified. + }, + ], + "strictPriorityPolicy": { # Specify configuration for StrictPriorityPolicy. + }, + }, "availableFeatures": [ # [Output only] List of features available for this Interconnect connection, which can take one of the following values: - IF_MACSEC If present then the Interconnect connection is provisioned on MACsec capable hardware ports. If not present then the Interconnect connection is provisioned on non-MACsec capable ports and MACsec isn't supported and enabling MACsec fails. "A String", ], @@ -742,7 +802,27 @@

Method Details

The object takes the form of: { # Represents an Interconnect resource. An Interconnect resource is a dedicated connection between the Google Cloud network and your on-premises network. For more information, read the Dedicated Interconnect Overview. + "aaiEnabled": True or False, # Enable or disable the application awareness feature on this Cloud Interconnect. "adminEnabled": True or False, # Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + "applicationAwareInterconnect": { # Configuration information for application awareness on this Cloud Interconnect. # Configuration information for application awareness on this Cloud Interconnect. + "bandwidthPercentagePolicy": { + "bandwidthPercentages": [ # Specify bandwidth percentages for various traffic classes for queuing type Bandwidth Percent. + { # Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified. + "percentage": 42, # Bandwidth percentage for a specific traffic class. + "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified. + }, + ], + }, + "profileDescription": "A String", # Description for the application awareness profile on this Cloud Interconnect. + "shapeAveragePercentages": [ # Optional field to specify a list of shape average percentages to be applied in conjunction with StrictPriorityPolicy or BandwidthPercentagePolicy. + { # Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified. + "percentage": 42, # Bandwidth percentage for a specific traffic class. + "trafficClass": "A String", # TrafficClass whose bandwidth percentage is being specified. + }, + ], + "strictPriorityPolicy": { # Specify configuration for StrictPriorityPolicy. + }, + }, "availableFeatures": [ # [Output only] List of features available for this Interconnect connection, which can take one of the following values: - IF_MACSEC If present then the Interconnect connection is provisioned on MACsec capable hardware ports. If not present then the Interconnect connection is provisioned on non-MACsec capable ports and MACsec isn't supported and enabling MACsec fails. "A String", ], diff --git a/docs/dyn/compute_v1.networks.html b/docs/dyn/compute_v1.networks.html index 1c4596871f3..ad26cd835a3 100644 --- a/docs/dyn/compute_v1.networks.html +++ b/docs/dyn/compute_v1.networks.html @@ -110,6 +110,9 @@

Instance Methods

removePeering(project, network, body=None, requestId=None, x__xgafv=None)

Removes a peering from the specified network.

+

+ requestRemovePeering(project, network, body=None, requestId=None, x__xgafv=None)

+

Requests to remove a peering from the specified network. Applicable only for PeeringConnection with update_strategy=CONSENSUS.

switchToCustomMode(project, network, requestId=None, x__xgafv=None)

Switches the network mode from auto subnet mode to custom subnet mode.

@@ -132,6 +135,20 @@

Method Details

"name": "A String", # Name of the peering, which should conform to RFC1035. "networkPeering": { # A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering. # Network peering parameters. In order to specify route policies for peering using import and export custom routes, you must specify all peering related parameters (name, peer network, exchange_subnet_routes) in the network_peering field. The corresponding fields in NetworksAddPeeringRequest will be deprecated soon. "autoCreateRoutes": True or False, # This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the local peering. This field provides information about the effective settings for the connection as a whole, including pending delete/update requests for CONSENSUS peerings. # [Output Only] The effective state of the peering connection as a whole. + "consensusState": { # The status of update/delete for a consensus peering connection. Only set when connection_status.update_strategy is CONSENSUS or a network peering is proposing to update the strategy to CONSENSUS. # The consensus state contains information about the status of update and delete for a consensus peering connection. + "deleteStatus": "A String", # The status of the delete request. + "updateStatus": "A String", # The status of the update request. + }, + "trafficConfiguration": { # The active connectivity settings for the peering connection based on the settings of the network peerings. + "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network. + "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the peer network. + "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network. + "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported from the peer network. + "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or exported between peer networks. + }, + "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this peering connection. + }, "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is false. "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field. @@ -143,6 +160,7 @@

Method Details

"stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY. "state": "A String", # [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network. "stateDetails": "A String", # [Output Only] Details about the current state of the peering. + "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the peering connection configuration. }, "peerNetwork": "A String", # URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network. } @@ -431,6 +449,20 @@

Method Details

"peerings": [ # [Output Only] A list of network peerings for the resource. { # A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering. "autoCreateRoutes": True or False, # This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the local peering. This field provides information about the effective settings for the connection as a whole, including pending delete/update requests for CONSENSUS peerings. # [Output Only] The effective state of the peering connection as a whole. + "consensusState": { # The status of update/delete for a consensus peering connection. Only set when connection_status.update_strategy is CONSENSUS or a network peering is proposing to update the strategy to CONSENSUS. # The consensus state contains information about the status of update and delete for a consensus peering connection. + "deleteStatus": "A String", # The status of the delete request. + "updateStatus": "A String", # The status of the update request. + }, + "trafficConfiguration": { # The active connectivity settings for the peering connection based on the settings of the network peerings. + "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network. + "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the peer network. + "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network. + "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported from the peer network. + "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or exported between peer networks. + }, + "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this peering connection. + }, "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is false. "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field. @@ -442,6 +474,7 @@

Method Details

"stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY. "state": "A String", # [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network. "stateDetails": "A String", # [Output Only] Details about the current state of the peering. + "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the peering connection configuration. }, ], "routingConfig": { # A routing configuration attached to a network resource. The message includes the list of routers associated with the network, and a flag indicating the type of routing behavior to enforce network-wide. # The network-level routing configuration for this network. Used by Cloud Router to determine what type of network-wide routing behavior to enforce. @@ -733,6 +766,20 @@

Method Details

"peerings": [ # [Output Only] A list of network peerings for the resource. { # A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering. "autoCreateRoutes": True or False, # This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the local peering. This field provides information about the effective settings for the connection as a whole, including pending delete/update requests for CONSENSUS peerings. # [Output Only] The effective state of the peering connection as a whole. + "consensusState": { # The status of update/delete for a consensus peering connection. Only set when connection_status.update_strategy is CONSENSUS or a network peering is proposing to update the strategy to CONSENSUS. # The consensus state contains information about the status of update and delete for a consensus peering connection. + "deleteStatus": "A String", # The status of the delete request. + "updateStatus": "A String", # The status of the update request. + }, + "trafficConfiguration": { # The active connectivity settings for the peering connection based on the settings of the network peerings. + "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network. + "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the peer network. + "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network. + "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported from the peer network. + "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or exported between peer networks. + }, + "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this peering connection. + }, "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is false. "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field. @@ -744,6 +791,7 @@

Method Details

"stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY. "state": "A String", # [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network. "stateDetails": "A String", # [Output Only] Details about the current state of the peering. + "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the peering connection configuration. }, ], "routingConfig": { # A routing configuration attached to a network resource. The message includes the list of routers associated with the network, and a flag indicating the type of routing behavior to enforce network-wide. # The network-level routing configuration for this network. Used by Cloud Router to determine what type of network-wide routing behavior to enforce. @@ -923,6 +971,20 @@

Method Details

"peerings": [ # [Output Only] A list of network peerings for the resource. { # A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering. "autoCreateRoutes": True or False, # This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the local peering. This field provides information about the effective settings for the connection as a whole, including pending delete/update requests for CONSENSUS peerings. # [Output Only] The effective state of the peering connection as a whole. + "consensusState": { # The status of update/delete for a consensus peering connection. Only set when connection_status.update_strategy is CONSENSUS or a network peering is proposing to update the strategy to CONSENSUS. # The consensus state contains information about the status of update and delete for a consensus peering connection. + "deleteStatus": "A String", # The status of the delete request. + "updateStatus": "A String", # The status of the update request. + }, + "trafficConfiguration": { # The active connectivity settings for the peering connection based on the settings of the network peerings. + "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network. + "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the peer network. + "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network. + "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported from the peer network. + "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or exported between peer networks. + }, + "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this peering connection. + }, "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is false. "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field. @@ -934,6 +996,7 @@

Method Details

"stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY. "state": "A String", # [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network. "stateDetails": "A String", # [Output Only] Details about the current state of the peering. + "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the peering connection configuration. }, ], "routingConfig": { # A routing configuration attached to a network resource. The message includes the list of routers associated with the network, and a flag indicating the type of routing behavior to enforce network-wide. # The network-level routing configuration for this network. Used by Cloud Router to determine what type of network-wide routing behavior to enforce. @@ -1081,6 +1144,20 @@

Method Details

"peerings": [ # [Output Only] A list of network peerings for the resource. { # A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering. "autoCreateRoutes": True or False, # This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the local peering. This field provides information about the effective settings for the connection as a whole, including pending delete/update requests for CONSENSUS peerings. # [Output Only] The effective state of the peering connection as a whole. + "consensusState": { # The status of update/delete for a consensus peering connection. Only set when connection_status.update_strategy is CONSENSUS or a network peering is proposing to update the strategy to CONSENSUS. # The consensus state contains information about the status of update and delete for a consensus peering connection. + "deleteStatus": "A String", # The status of the delete request. + "updateStatus": "A String", # The status of the update request. + }, + "trafficConfiguration": { # The active connectivity settings for the peering connection based on the settings of the network peerings. + "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network. + "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the peer network. + "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network. + "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported from the peer network. + "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or exported between peer networks. + }, + "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this peering connection. + }, "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is false. "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field. @@ -1092,6 +1169,7 @@

Method Details

"stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY. "state": "A String", # [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network. "stateDetails": "A String", # [Output Only] Details about the current state of the peering. + "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the peering connection configuration. }, ], "routingConfig": { # A routing configuration attached to a network resource. The message includes the list of routers associated with the network, and a flag indicating the type of routing behavior to enforce network-wide. # The network-level routing configuration for this network. Used by Cloud Router to determine what type of network-wide routing behavior to enforce. @@ -1357,6 +1435,137 @@

Method Details

} +
+ requestRemovePeering(project, network, body=None, requestId=None, x__xgafv=None) + 
Requests to remove a peering from the specified network. Applicable only for PeeringConnection with update_strategy=CONSENSUS.
+
+Args:
+  project: string, Project ID for this request. (required)
+  network: string, Name of the network resource to remove peering from. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "name": "A String", # Name of the peering, which should conform to RFC1035.
+}
+
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource. Google Compute Engine has three Operation resources: * [Global](/compute/docs/reference/rest/v1/globalOperations) * [Regional](/compute/docs/reference/rest/v1/regionOperations) * [Zonal](/compute/docs/reference/rest/v1/zoneOperations) You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses. Operations can be global, regional or zonal. - For global operations, use the `globalOperations` resource. - For regional operations, use the `regionOperations` resource. - For zonal operations, use the `zoneOperations` resource. For more information, read Global, Regional, and Zonal Resources. Note that completed Operation resources have a limited retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a `404` means the resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key). Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "setCommonInstanceMetadataOperationMetadata": { # [Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key). Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # [Output Only] If state is `ABANDONED` or `FAILED`, this field is populated.
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+        },
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com` or `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+        {
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
+        },
+      ],
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
+    },
+  ],
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
+}
+
+
switchToCustomMode(project, network, requestId=None, x__xgafv=None) 
Switches the network mode from auto subnet mode to custom subnet mode.
@@ -1494,6 +1703,20 @@ 
Method Details

 {
   "networkPeering": { # A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering.
     "autoCreateRoutes": True or False, # This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE.
+    "connectionStatus": { # [Output Only] Describes the state of a peering connection, not just the local peering. This field provides information about the effective settings for the connection as a whole, including pending delete/update requests for CONSENSUS peerings. # [Output Only] The effective state of the peering connection as a whole.
+      "consensusState": { # The status of update/delete for a consensus peering connection. Only set when connection_status.update_strategy is CONSENSUS or a network peering is proposing to update the strategy to CONSENSUS. # The consensus state contains information about the status of update and delete for a consensus peering connection.
+        "deleteStatus": "A String", # The status of the delete request.
+        "updateStatus": "A String", # The status of the update request.
+      },
+      "trafficConfiguration": { # The active connectivity settings for the peering connection based on the settings of the network peerings.
+        "exportCustomRoutesToPeer": True or False, # Whether custom routes are being exported to the peer network.
+        "exportSubnetRoutesWithPublicIpToPeer": True or False, # Whether subnet routes with public IP ranges are being exported to the peer network.
+        "importCustomRoutesFromPeer": True or False, # Whether custom routes are being imported from the peer network.
+        "importSubnetRoutesWithPublicIpFromPeer": True or False, # Whether subnet routes with public IP ranges are being imported from the peer network.
+        "stackType": "A String", # Which IP version(s) of traffic and routes are being imported or exported between peer networks.
+      },
+      "updateStrategy": "A String", # The update strategy determines the update/delete semantics for this peering connection.
+    },
     "exchangeSubnetRoutes": True or False, # Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE.
     "exportCustomRoutes": True or False, # Whether to export the custom routes to peer network. The default value is false.
     "exportSubnetRoutesWithPublicIp": True or False, # Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field.
@@ -1505,6 +1728,7 @@ 
Method Details

     "stackType": "A String", # Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY.
     "state": "A String", # [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network.
     "stateDetails": "A String", # [Output Only] Details about the current state of the peering.
+    "updateStrategy": "A String", # The update strategy determines the semantics for updates and deletes to the peering connection configuration.
   },
 }
 
diff --git a/docs/dyn/compute_v1.regionBackendServices.html b/docs/dyn/compute_v1.regionBackendServices.html
index f76d11d40a0..ab5d224f86b 100644
--- a/docs/dyn/compute_v1.regionBackendServices.html
+++ b/docs/dyn/compute_v1.regionBackendServices.html
@@ -456,6 +456,11 @@ 
Method Details

     "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG.
     "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG.
   },
+  "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.
+    "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid.
+      "a_key": "A String",
+    },
+  },
   "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port.
   "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name.
   "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy.
@@ -807,6 +812,11 @@ 
Method Details

     "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG.
     "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG.
   },
+  "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.
+    "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid.
+      "a_key": "A String",
+    },
+  },
   "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port.
   "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name.
   "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy.
@@ -1189,6 +1199,11 @@ 
Method Details

         "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG.
         "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG.
       },
+      "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.
+        "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid.
+          "a_key": "A String",
+        },
+      },
       "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port.
       "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name.
       "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy.
@@ -1470,6 +1485,11 @@ 
Method Details

         "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG.
         "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG.
       },
+      "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.
+        "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid.
+          "a_key": "A String",
+        },
+      },
       "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port.
       "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name.
       "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy.
@@ -1767,6 +1787,11 @@ 
Method Details

     "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG.
     "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG.
   },
+  "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.
+    "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid.
+      "a_key": "A String",
+    },
+  },
   "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port.
   "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name.
   "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy.
@@ -2402,6 +2427,11 @@ 
Method Details

     "successRateRequestVolume": 42, # The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG.
     "successRateStdevFactor": 42, # This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG.
   },
+  "params": { # Additional Backend Service parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.
+    "resourceManagerTags": { # Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid.
+      "a_key": "A String",
+    },
+  },
   "port": 42, # Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port.
   "portName": "A String", # A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name.
   "protocol": "A String", # The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy.
diff --git a/docs/dyn/compute_v1.regionCommitments.html b/docs/dyn/compute_v1.regionCommitments.html
index fe2120c3852..a503a14695c 100644
--- a/docs/dyn/compute_v1.regionCommitments.html
+++ b/docs/dyn/compute_v1.regionCommitments.html
@@ -150,6 +150,9 @@ 
Method Details

           "region": "A String", # [Output Only] URL of the region where the commitment and committed resources are located.
           "reservations": [ # The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead.
             { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.
+              "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations.
+                "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+              },
               "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility.
                 "inUseResources": [ # [Output only] List of resources currently in use.
                   {
@@ -375,6 +378,9 @@ 
Method Details

   "region": "A String", # [Output Only] URL of the region where the commitment and committed resources are located.
   "reservations": [ # The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead.
     { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.
+      "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations.
+        "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+      },
       "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility.
         "inUseResources": [ # [Output only] List of resources currently in use.
           {
@@ -545,6 +551,9 @@ 
Method Details

   "region": "A String", # [Output Only] URL of the region where the commitment and committed resources are located.
   "reservations": [ # The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead.
     { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.
+      "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations.
+        "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+      },
       "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility.
         "inUseResources": [ # [Output only] List of resources currently in use.
           {
@@ -844,6 +853,9 @@ 
Method Details

       "region": "A String", # [Output Only] URL of the region where the commitment and committed resources are located.
       "reservations": [ # The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead.
         { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.
+          "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations.
+            "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+          },
           "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility.
             "inUseResources": [ # [Output only] List of resources currently in use.
               {
@@ -1044,6 +1056,9 @@ 
Method Details

   "region": "A String", # [Output Only] URL of the region where the commitment and committed resources are located.
   "reservations": [ # The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead.
     { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.
+      "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations.
+        "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+      },
       "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility.
         "inUseResources": [ # [Output only] List of resources currently in use.
           {
diff --git a/docs/dyn/compute_v1.reservations.html b/docs/dyn/compute_v1.reservations.html
index 8ecb244403c..28d54101678 100644
--- a/docs/dyn/compute_v1.reservations.html
+++ b/docs/dyn/compute_v1.reservations.html
@@ -144,6 +144,9 @@ 
Method Details

     "a_key": { # Name of the scope containing this set of reservations.
       "reservations": [ # A list of reservations contained in this scope.
         { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.
+          "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations.
+            "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+          },
           "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility.
             "inUseResources": [ # [Output only] List of resources currently in use.
               {
@@ -452,6 +455,9 @@ 
Method Details

   An object of the form:
 
     { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.
+  "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations.
+    "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+  },
   "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility.
     "inUseResources": [ # [Output only] List of resources currently in use.
       {
@@ -630,6 +636,9 @@ 
Method Details

     The object takes the form of:
 
 { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.
+  "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations.
+    "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+  },
   "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility.
     "inUseResources": [ # [Output only] List of resources currently in use.
       {
@@ -887,6 +896,9 @@ 
Method Details

   "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
   "items": [ # [Output Only] A list of Allocation resources.
     { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.
+      "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations.
+        "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+      },
       "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility.
         "inUseResources": [ # [Output only] List of resources currently in use.
           {
@@ -1442,6 +1454,9 @@ 
Method Details

     The object takes the form of:
 
 { # Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.
+  "advancedDeploymentControl": { # Advance control for cluster management, applicable only to DENSE deployment type reservations. # Advanced control for cluster management, applicable only to DENSE deployment type reservations.
+    "reservationOperationalMode": "A String", # Indicates chosen reservation operational mode for the reservation.
+  },
   "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. # Reservation for aggregated resources, providing shape flexibility.
     "inUseResources": [ # [Output only] List of resources currently in use.
       {
diff --git a/docs/dyn/compute_v1.resourcePolicies.html b/docs/dyn/compute_v1.resourcePolicies.html
index 476eaa1b21d..07c276d678d 100644
--- a/docs/dyn/compute_v1.resourcePolicies.html
+++ b/docs/dyn/compute_v1.resourcePolicies.html
@@ -209,10 +209,10 @@ 
Method Details

             },
           },
           "status": "A String", # [Output Only] The status of resource policy creation.
-          "workloadPolicy": { # Represents the workload policy.
-            "acceleratorTopology": "A String",
-            "maxTopologyDistance": "A String",
-            "type": "A String",
+          "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs.
+            "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs.
+            "maxTopologyDistance": "A String", # Specifies the maximum distance between instances.
+            "type": "A String", # Specifies the intent of the instance placement in the MIG.
           },
         },
       ],
@@ -478,10 +478,10 @@ 
Method Details

     },
   },
   "status": "A String", # [Output Only] The status of resource policy creation.
-  "workloadPolicy": { # Represents the workload policy.
-    "acceleratorTopology": "A String",
-    "maxTopologyDistance": "A String",
-    "type": "A String",
+  "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs.
+    "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs.
+    "maxTopologyDistance": "A String", # Specifies the maximum distance between instances.
+    "type": "A String", # Specifies the intent of the instance placement in the MIG.
   },
 }
@@ -617,10 +617,10 @@

Method Details

}, }, "status": "A String", # [Output Only] The status of resource policy creation. - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, } @@ -836,10 +836,10 @@

Method Details

}, }, "status": "A String", # [Output Only] The status of resource policy creation. - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, }, ], @@ -955,10 +955,10 @@

Method Details

}, }, "status": "A String", # [Output Only] The status of resource policy creation. - "workloadPolicy": { # Represents the workload policy. - "acceleratorTopology": "A String", - "maxTopologyDistance": "A String", - "type": "A String", + "workloadPolicy": { # Represents the workload policy. # Resource policy for defining instance placement for MIGs. + "acceleratorTopology": "A String", # Specifies the topology required to create a partition for VMs that have interconnected GPUs. + "maxTopologyDistance": "A String", # Specifies the maximum distance between instances. + "type": "A String", # Specifies the intent of the instance placement in the MIG. }, } diff --git a/googleapiclient/discovery_cache/documents/compute.alpha.json b/googleapiclient/discovery_cache/documents/compute.alpha.json index d5f8cbd88fb..387f1613006 100644 --- a/googleapiclient/discovery_cache/documents/compute.alpha.json +++ b/googleapiclient/discovery_cache/documents/compute.alpha.json @@ -7653,6 +7653,52 @@ }, "haControllers": { "methods": { +"delete": { +"description": "Deletes an HaController in the specified project.", +"flatPath": "projects/{project}/regions/{region}/haControllers/{haController}", +"httpMethod": "DELETE", +"id": "compute.haControllers.delete", +"parameterOrder": [ +"project", +"region", +"haController" +], +"parameters": { +"haController": { +"description": "Name of the HaController resource to delete.", +"location": "path", +"required": true, +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/haControllers/{haController}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, "failover": { "description": "Fails over a VM targeted by the specified HaController to the selected zone.", "flatPath": "projects/{project}/regions/{region}/haControllers/{haController}/failover", @@ -7702,6 +7748,210 @@ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/compute" ] +}, +"get": { +"description": "Returns all the details of a specific HaController.", +"flatPath": "projects/{project}/regions/{region}/haControllers/{haController}", +"httpMethod": "GET", +"id": "compute.haControllers.get", +"parameterOrder": [ +"project", +"region", +"haController" +], +"parameters": { +"haController": { +"description": "Name of the HaController resource to return.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/haControllers/{haController}", +"response": { +"$ref": "HaController" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"description": "Creates HaController in the specified project.", +"flatPath": "projects/{project}/regions/{region}/haControllers", +"httpMethod": "POST", +"id": "compute.haControllers.insert", +"parameterOrder": [ +"project", +"region" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/haControllers", +"request": { +"$ref": "HaController" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"description": "Lists all HaControllers in the specified project in the specified region.", +"flatPath": "projects/{project}/regions/{region}/haControllers", +"httpMethod": "GET", +"id": "compute.haControllers.list", +"parameterOrder": [ +"project", +"region" +], +"parameters": { +"filter": { +"description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", +"location": "query", +"type": "string" +}, +"maxResults": { +"default": "500", +"description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", +"format": "uint32", +"location": "query", +"minimum": "0", +"type": "integer" +}, +"orderBy": { +"description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", +"location": "query", +"type": "string" +}, +"pageToken": { +"description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", +"location": "query", +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"returnPartialSuccess": { +"description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/regions/{region}/haControllers", +"response": { +"$ref": "HaControllersList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"description": "Updates HaController in the specified project.", +"flatPath": "projects/{project}/regions/{region}/haControllers/{haController}", +"httpMethod": "PATCH", +"id": "compute.haControllers.patch", +"parameterOrder": [ +"project", +"region", +"haController" +], +"parameters": { +"haController": { +"description": "ID of the HaController resource to update.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.", +"location": "query", +"type": "string" +}, +"updateMask": { +"description": "update_mask indicates fields to be updated as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/haControllers/{haController}", +"request": { +"$ref": "HaController" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] } } }, @@ -28898,6 +29148,72 @@ }, "regionHealthAggregationPolicies": { "methods": { +"aggregatedList": { +"description": "Retrieves the list of all HealthAggregationPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/healthAggregationPolicies", +"httpMethod": "GET", +"id": "compute.regionHealthAggregationPolicies.aggregatedList", +"parameterOrder": [ +"project" +], +"parameters": { +"filter": { +"description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", +"location": "query", +"type": "string" +}, +"includeAllScopes": { +"description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", +"location": "query", +"type": "boolean" +}, +"maxResults": { +"default": "500", +"description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", +"format": "uint32", +"location": "query", +"minimum": "0", +"type": "integer" +}, +"orderBy": { +"description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", +"location": "query", +"type": "string" +}, +"pageToken": { +"description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", +"location": "query", +"type": "string" +}, +"project": { +"description": "Name of the project scoping this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"returnPartialSuccess": { +"description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", +"location": "query", +"type": "boolean" +}, +"serviceProjectNumber": { +"description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", +"format": "int64", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/aggregated/healthAggregationPolicies", +"response": { +"$ref": "HealthAggregationPolicyAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, "delete": { "description": "Deletes the specified HealthAggregationPolicy in the given region.", "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", @@ -38844,6 +39160,60 @@ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/compute" ] +}, +"reportFaulty": { +"description": "Allows customers to report a faulty subBlock.", +"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", +"httpMethod": "POST", +"id": "compute.reservationSubBlocks.reportFaulty", +"parameterOrder": [ +"project", +"zone", +"parentName", +"reservationSubBlock" +], +"parameters": { +"parentName": { +"description": "The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name}", +"location": "path", +"required": true, +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", +"location": "query", +"type": "string" +}, +"reservationSubBlock": { +"description": "The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID.", +"location": "path", +"required": true, +"type": "string" +}, +"zone": { +"description": "Name of the zone for this request. Zone name should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", +"request": { +"$ref": "ReservationSubBlocksReportFaultyRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] } } }, @@ -50770,7 +51140,7 @@ } } }, -"revision": "20250728", +"revision": "20250729", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -52112,6 +52482,21 @@ false "description": "This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation.", "id": "AllocationAggregateReservation", "properties": { +"hostCount": { +"description": "Count of reserved hosts of specified VM family. The host has fixed number of accelerators based on the accelerator/vm-family selected.", +"format": "int32", +"type": "integer" +}, +"inUseHostCount": { +"description": "Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use.", +"format": "int32", +"type": "integer" +}, +"inUseInstanceCount": { +"description": "Number of instances currently in use in this reservation.", +"format": "int32", +"type": "integer" +}, "inUseResources": { "description": "[Output only] List of resources currently in use.", "items": { @@ -52135,7 +52520,8 @@ false "VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E", "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P", "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P", -"VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P" +"VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P", +"VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X" ], "enumDescriptions": [ "", @@ -52144,6 +52530,7 @@ false "", "", "", +"", "" ], "type": "string" @@ -53650,12 +54037,14 @@ false "enum": [ "CONNECTION", "CUSTOM_METRICS", +"IN_FLIGHT", "RATE", "UTILIZATION" ], "enumDescriptions": [ "Balance based on the number of simultaneous connections.", "Based on custom defined and reported metrics.", +"Balance based on the number of in-flight requests.", "Balance based on requests per second (RPS).", "Balance based on the backend utilization." ], @@ -53700,6 +54089,21 @@ false "format": "int32", "type": "integer" }, +"maxInFlightRequests": { +"description": "Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION.", +"format": "int32", +"type": "integer" +}, +"maxInFlightRequestsPerEndpoint": { +"description": "Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION.", +"format": "int32", +"type": "integer" +}, +"maxInFlightRequestsPerInstance": { +"description": "Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION.", +"format": "int32", +"type": "integer" +}, "maxRate": { "description": "Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.", "format": "int32", @@ -53733,6 +54137,19 @@ false "Traffic will be sent to this backend first." ], "type": "string" +}, +"trafficDuration": { +"enum": [ +"LONG", +"SHORT", +"TRAFFIC_DURATION_UNSPECIFIED" +], +"enumDescriptions": [ +"Most of the requests are expected to take more than multiple seconds to finish.", +"Most requests are expected to finish with a sub-second latency.", +"Traffic duration is unspecified." +], +"type": "string" } }, "type": "object" @@ -56697,7 +57114,7 @@ false "id": "CapacityAdviceResponse", "properties": { "recommendations": { -"description": "Initially the API will provide one recommendation which balances the individual scores according to Google's preference.", +"description": "Initially the API will provide one recommendation which balances the individual scores according to service provider's preference.", "items": { "$ref": "CapacityAdviceResponseRecommendation" }, @@ -60624,6 +61041,10 @@ false "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, +"params": { +"$ref": "ExternalVpnGatewayParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload." +}, "redundancyType": { "description": "Indicates the user-supplied redundancy type of this external VPN gateway.", "enum": [ @@ -60823,6 +61244,19 @@ false }, "type": "object" }, +"ExternalVpnGatewayParams": { +"id": "ExternalVpnGatewayParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"} * {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {\"123/environment\" : \"tagValues/444\"} is invalid. * Inconsistent format is not supported. For instance: {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", +"type": "object" +} +}, +"type": "object" +}, "FileContentBuffer": { "id": "FileContentBuffer", "properties": { @@ -62868,6 +63302,20 @@ false ], "type": "string" }, +"protectionTier": { +"description": "Protection tier for the workload.", +"enum": [ +"CAPACITY_OPTIMIZED", +"PROTECTION_TIER_UNSPECIFIED", +"STANDARD" +], +"enumDescriptions": [ +"CAPACITY_OPTIMIZED capacity leverages redundancies (e.g. power, cooling) at the data center during normal operating conditions. In the event of infrastructure failures at data center (e.g. power and/or cooling failures), this workload may be disrupted. As a consequence, it has a weaker availability SLO than STANDARD.", +"Unspecified protection tier.", +"STANDARD protection for workload that should be protected by redundancies (e.g. power, cooling) at the data center level. In the event of infrastructure failures at data center (e.g. power and/or cooling failures), this workload is expected to continue as normal using the redundancies." +], +"type": "string" +}, "reservationMode": { "description": "The reservation mode which determines reservation-termination behavior and expected pricing.", "enum": [ @@ -63786,7 +64234,8 @@ false "VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E", "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P", "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P", -"VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P" +"VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P", +"VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X" ], "enumDescriptions": [ "", @@ -63795,6 +64244,7 @@ false "", "", "", +"", "" ], "type": "string" @@ -64482,6 +64932,378 @@ false }, "type": "object" }, +"HaController": { +"description": "HaController handles failover for a VM Instance.", +"id": "HaController", +"properties": { +"creationTimestamp": { +"description": "[Output Only] Creation timestamp in RFC3339 text format.", +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you create the resource.", +"type": "string" +}, +"failoverInitiation": { +"description": "Indicates how failover should be initiated.", +"enum": [ +"FAILOVER_INITIATION_UNSPECIFIED", +"MANUAL_ONLY" +], +"enumDescriptions": [ +"", +"Failover will be initiated only when compute.haControllers.failover method is called." +], +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", +"format": "uint64", +"type": "string" +}, +"instanceName": { +"description": "Name of the instance that HaController is in charge of. If not specified the HaController's resource name will be used instead. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"kind": { +"default": "compute#HaController", +"description": "[Output Only] Type of the resource. Always compute#haController for HaControllers.", +"type": "string" +}, +"name": { +"description": "Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"region": { +"description": "[Output Only] URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", +"type": "string" +}, +"secondaryZoneCapacity": { +"description": "Indicates the capacity guarantees in the secondary zone.", +"enum": [ +"BEST_EFFORT", +"SECONDARY_ZONE_CAPACITY_UNSPECIFIED" +], +"enumDescriptions": [ +"Failover will succeed only if at the time of failover the secondary zone has enough capacity to host the instance.", +"" +], +"type": "string" +}, +"selfLink": { +"description": "[Output only] Server-defined URL for the resource.", +"type": "string" +}, +"selfLinkWithId": { +"description": "[Output Only] Server-defined URL for this resource with the resource id.", +"type": "string" +}, +"status": { +"$ref": "HaControllerStatus", +"description": "[Output Only] Status information for the HaController resource." +}, +"zoneConfigurations": { +"additionalProperties": { +"$ref": "HaControllerZoneConfiguration" +}, +"description": "Map of zone configurations Key: name of the zone Value: ZoneConfiguration", +"type": "object" +} +}, +"type": "object" +}, +"HaControllerStatus": { +"description": "Contains information about current status of the HaController.", +"id": "HaControllerStatus", +"properties": { +"failoverProgress": { +"$ref": "HaControllerStatusFailoverProgress", +"description": "[Output Only] Contains the details of the ongoing failover. This message is not displayed if failover is NOT in progress." +}, +"ongoingFailover": { +"description": "[Output Only] Indicates if the failover is currently in-progress.", +"type": "boolean" +}, +"primaryInstance": { +"description": "[Output Only] The URL to the instance that is intended to be primary at this moment. Primary instance will be changed at the very beginning of a failover operation.", +"type": "string" +}, +"primaryZone": { +"description": "[Output Only] The name of the zone that is intended to be primary at this moment. Primary zone will be changed at the very beginning of a failover operation. The zone may not be operational in the middle of a failover operation.", +"type": "string" +}, +"readyForFailover": { +"description": "[Output Only] Indicates if the resource is ready for initiating a failover to the secondary zone.", +"type": "boolean" +}, +"zoneStatus": { +"additionalProperties": { +"$ref": "HaControllerStatusZoneStatus" +}, +"description": "[Output Only] Map of zone statuses. Key: name of the zone Value: ZoneStatus", +"type": "object" +} +}, +"type": "object" +}, +"HaControllerStatusFailoverProgress": { +"description": "Contains information about the current failover operation.", +"id": "HaControllerStatusFailoverProgress", +"properties": { +"failoverTrigger": { +"description": "[Output Only] Indicates if failover has been triggered automatically or manually.", +"enum": [ +"AUTOMATIC", +"FAILOVER_TRIGGER_UNSPECIFIED", +"MANUAL" +], +"enumDescriptions": [ +"Failover has been triggered automatically.", +"", +"Failover has been triggered manually." +], +"type": "string" +}, +"failoverTriggerTimestamp": { +"description": "[Output Only] Timestamp of the last failover trigger.", +"format": "google-datetime", +"type": "string" +}, +"lastFailoverAttempt": { +"$ref": "HaControllerStatusFailoverProgressLastFailoverAttempt", +"description": "[Output Only] Contains details of the last failed failover. This field is filled only if the current failover is failing" +} +}, +"type": "object" +}, +"HaControllerStatusFailoverProgressLastFailoverAttempt": { +"id": "HaControllerStatusFailoverProgressLastFailoverAttempt", +"properties": { +"errors": { +"description": "[Output Only] Encountered errors during the last attempt to process failover.", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this operation.", +"items": { +"properties": { +"code": { +"description": "[Output Only] The error type identifier for this error.", +"type": "string" +}, +"errorDetails": { +"description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", +"items": { +"properties": { +"errorInfo": { +"$ref": "ErrorInfo" +}, +"help": { +"$ref": "Help" +}, +"localizedMessage": { +"$ref": "LocalizedMessage" +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo" +} +}, +"type": "object" +}, +"type": "array" +}, +"location": { +"description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", +"type": "string" +}, +"message": { +"description": "[Output Only] An optional, human-readable error message.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +} +}, +"type": "object" +}, +"timestamp": { +"description": "[Output Only] Show timestamp only if there is an error. RFC3339 text format.", +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, +"HaControllerStatusZoneStatus": { +"description": "Contains the status of a specific zone.", +"id": "HaControllerStatusZoneStatus", +"properties": { +"isPrimary": { +"description": "[Output Only] Indicates if the zone is primary at this moment.", +"type": "boolean" +}, +"isZoneReady": { +"description": "[Output Only] Indicates if the zone is ready for initiating a failover.", +"type": "boolean" +}, +"lastError": { +"$ref": "HaControllerStatusZoneStatusLastError", +"description": "[Output Only] This field is filled only if the current operation is failing." +} +}, +"type": "object" +}, +"HaControllerStatusZoneStatusLastError": { +"description": "Contains details of the last failed operation.", +"id": "HaControllerStatusZoneStatusLastError", +"properties": { +"errors": { +"description": "[Output Only] Encountered errors.", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this operation.", +"items": { +"properties": { +"code": { +"description": "[Output Only] The error type identifier for this error.", +"type": "string" +}, +"errorDetails": { +"description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", +"items": { +"properties": { +"errorInfo": { +"$ref": "ErrorInfo" +}, +"help": { +"$ref": "Help" +}, +"localizedMessage": { +"$ref": "LocalizedMessage" +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo" +} +}, +"type": "object" +}, +"type": "array" +}, +"location": { +"description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", +"type": "string" +}, +"message": { +"description": "[Output Only] An optional, human-readable error message.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +} +}, +"type": "object" +}, +"timestamp": { +"description": "[Output Only] Show timestamp only if there is an error. RFC3339 text format.", +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, +"HaControllerZoneConfiguration": { +"description": "Config for a zone that the HaController may use for running the VM instance.", +"id": "HaControllerZoneConfiguration", +"properties": { +"nodeAffinities": { +"description": "A set of node affinity configurations. Refer to Configuring node affinity for more information. Overrides reservationAffinity.", +"items": { +"$ref": "HaControllerZoneConfigurationNodeAffinity" +}, +"type": "array" +}, +"reservationAffinity": { +"$ref": "HaControllerZoneConfigurationReservationAffinity", +"description": "Specifies the reservations that the instance can consume from." +} +}, +"type": "object" +}, +"HaControllerZoneConfigurationNodeAffinity": { +"description": "Node Affinity: the configuration of desired nodes onto which the Instance could be scheduled. This message should be an exact copy of the Instances representation of NodeAffinity. LINT.IfChange(HaControllerNodeAffinityMixer)", +"id": "HaControllerZoneConfigurationNodeAffinity", +"properties": { +"key": { +"description": "Corresponds to the label key of Node resource.", +"type": "string" +}, +"operator": { +"description": "Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity.", +"enum": [ +"IN", +"NOT_IN", +"OPERATOR_UNSPECIFIED" +], +"enumDescriptions": [ +"Requires Compute Engine to seek for matched nodes.", +"Requires Compute Engine to avoid certain nodes.", +"" +], +"type": "string" +}, +"values": { +"description": "Corresponds to the label values of Node resource.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"HaControllerZoneConfigurationReservationAffinity": { +"description": "Specifies the reservations that this instance can consume from. This message should be an exact copy of the Instances representation of AllocationAffinity. LINT.IfChange(HaControllerAllocationAffinityMixer)", +"id": "HaControllerZoneConfigurationReservationAffinity", +"properties": { +"consumeReservationType": { +"description": "Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples.", +"enum": [ +"ANY_RESERVATION", +"NO_RESERVATION", +"SPECIFIC_RESERVATION", +"SPECIFIC_THEN_ANY_RESERVATION", +"SPECIFIC_THEN_NO_RESERVATION", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Consume any allocation available.", +"Do not consume from any allocated capacity.", +"Must consume from a specific reservation. Must specify key value fields for specifying the reservations.", +"Prefer to consume from a specific reservation, but still consume any reservation available if the specified reservation is not available or exhausted. Must specify key value fields for specifying the reservations.", +"Prefer to consume from a specific reservation, but still consume from the on-demand pool if the specified reservation is exhausted. Must specify key value fields for specifying the reservations.", +"" +], +"type": "string" +}, +"key": { +"description": "Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, specify googleapis.com/reservation-name as the key and specify the name of your reservation as its value.", +"type": "string" +}, +"values": { +"description": "Corresponds to the label values of a reservation resource. This can be either a name to a reservation in the same project or \"projects/different-project/reservations/some-reservation-name\" to target a shared reservation in the same zone but in a different project.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, "HaControllersFailoverRequest": { "id": "HaControllersFailoverRequest", "properties": { @@ -64493,6 +65315,302 @@ false }, "type": "object" }, +"HaControllersList": { +"id": "HaControllersList", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of HaControllers in the specified project and region.", +"items": { +"$ref": "HaController" +}, +"type": "array" +}, +"nextPageToken": { +"description": "This token allows you to get the next page of results for maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", +"type": "string" +}, +"selfLink": { +"description": "[Output only] Server-defined URL for this resource.", +"type": "string" +}, +"unreachables": { +"description": "[Output only] Unreachable resources.", +"items": { +"type": "string" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning message.", +"properties": { +"code": { +"description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", +"enum": [ +"CLEANUP_FAILED", +"DEPRECATED_RESOURCE_USED", +"DEPRECATED_TYPE_USED", +"DISK_SIZE_LARGER_THAN_IMAGE_SIZE", +"EXPERIMENTAL_TYPE_USED", +"EXTERNAL_API_WARNING", +"FIELD_VALUE_OVERRIDEN", +"INJECTED_KERNELS_DEPRECATED", +"INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", +"LARGE_DEPLOYMENT_WARNING", +"LIST_OVERHEAD_QUOTA_EXCEED", +"MISSING_TYPE_DEPENDENCY", +"NEXT_HOP_ADDRESS_NOT_ASSIGNED", +"NEXT_HOP_CANNOT_IP_FORWARD", +"NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", +"NEXT_HOP_INSTANCE_NOT_FOUND", +"NEXT_HOP_INSTANCE_NOT_ON_NETWORK", +"NEXT_HOP_NOT_RUNNING", +"NOT_CRITICAL_ERROR", +"NO_RESULTS_ON_PAGE", +"PARTIAL_SUCCESS", +"QUOTA_INFO_UNAVAILABLE", +"REQUIRED_TOS_AGREEMENT", +"RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", +"RESOURCE_NOT_DELETED", +"SCHEMA_VALIDATION_IGNORED", +"SINGLE_INSTANCE_PROPERTY_TEMPLATE", +"UNDECLARED_PROPERTIES", +"UNREACHABLE" +], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +true, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false +], +"enumDescriptions": [ +"Warning about failed cleanup of transient changes made by a failed operation.", +"A link to a deprecated resource was created.", +"When deploying and at least one of the resources has a type marked as deprecated", +"The user created a boot disk that is larger than image size.", +"When deploying and at least one of the resources has a type marked as experimental", +"Warning that is present in an external api call", +"Warning that value of a field has been overridden. Deprecated unused field.", +"The operation involved use of an injected kernel, which is deprecated.", +"A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", +"When deploying a deployment with a exceedingly large number of resources", +"Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", +"A resource depends on a missing type", +"The route's nextHopIp address is not assigned to an instance on the network.", +"The route's next hop instance cannot ip forward.", +"The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", +"The route's nextHopInstance URL refers to an instance that does not exist.", +"The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", +"The route's next hop instance does not have a status of RUNNING.", +"Error which is not critical. We decided to continue the process despite the mentioned error.", +"No results are present on a particular list page.", +"Success is reported, but some results may be missing due to errors", +"Quota information is not available to client requests (e.g: regions.list).", +"The user attempted to use a resource that requires a TOS they have not accepted.", +"Warning that a resource is in use.", +"One or more of the resources set to auto-delete could not be deleted because they were in use.", +"When a resource schema validation is ignored.", +"Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", +"When undeclared properties in the schema are present", +"A given scope cannot be reached." +], +"type": "string" +}, +"data": { +"description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", +"items": { +"properties": { +"key": { +"description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", +"type": "string" +}, +"value": { +"description": "[Output Only] A warning data value corresponding to the key.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +}, +"message": { +"description": "[Output Only] A human-readable description of the warning code.", +"type": "string" +} +}, +"type": "object" +} +}, +"type": "object" +}, +"HealthAggregationPoliciesScopedList": { +"id": "HealthAggregationPoliciesScopedList", +"properties": { +"healthAggregationPolicies": { +"description": "A list of HealthAggregationPolicys contained in this scope.", +"items": { +"$ref": "HealthAggregationPolicy" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of health aggregation policies when the list is empty.", +"properties": { +"code": { +"description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", +"enum": [ +"CLEANUP_FAILED", +"DEPRECATED_RESOURCE_USED", +"DEPRECATED_TYPE_USED", +"DISK_SIZE_LARGER_THAN_IMAGE_SIZE", +"EXPERIMENTAL_TYPE_USED", +"EXTERNAL_API_WARNING", +"FIELD_VALUE_OVERRIDEN", +"INJECTED_KERNELS_DEPRECATED", +"INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", +"LARGE_DEPLOYMENT_WARNING", +"LIST_OVERHEAD_QUOTA_EXCEED", +"MISSING_TYPE_DEPENDENCY", +"NEXT_HOP_ADDRESS_NOT_ASSIGNED", +"NEXT_HOP_CANNOT_IP_FORWARD", +"NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", +"NEXT_HOP_INSTANCE_NOT_FOUND", +"NEXT_HOP_INSTANCE_NOT_ON_NETWORK", +"NEXT_HOP_NOT_RUNNING", +"NOT_CRITICAL_ERROR", +"NO_RESULTS_ON_PAGE", +"PARTIAL_SUCCESS", +"QUOTA_INFO_UNAVAILABLE", +"REQUIRED_TOS_AGREEMENT", +"RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", +"RESOURCE_NOT_DELETED", +"SCHEMA_VALIDATION_IGNORED", +"SINGLE_INSTANCE_PROPERTY_TEMPLATE", +"UNDECLARED_PROPERTIES", +"UNREACHABLE" +], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +true, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false +], +"enumDescriptions": [ +"Warning about failed cleanup of transient changes made by a failed operation.", +"A link to a deprecated resource was created.", +"When deploying and at least one of the resources has a type marked as deprecated", +"The user created a boot disk that is larger than image size.", +"When deploying and at least one of the resources has a type marked as experimental", +"Warning that is present in an external api call", +"Warning that value of a field has been overridden. Deprecated unused field.", +"The operation involved use of an injected kernel, which is deprecated.", +"A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", +"When deploying a deployment with a exceedingly large number of resources", +"Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", +"A resource depends on a missing type", +"The route's nextHopIp address is not assigned to an instance on the network.", +"The route's next hop instance cannot ip forward.", +"The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", +"The route's nextHopInstance URL refers to an instance that does not exist.", +"The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", +"The route's next hop instance does not have a status of RUNNING.", +"Error which is not critical. We decided to continue the process despite the mentioned error.", +"No results are present on a particular list page.", +"Success is reported, but some results may be missing due to errors", +"Quota information is not available to client requests (e.g: regions.list).", +"The user attempted to use a resource that requires a TOS they have not accepted.", +"Warning that a resource is in use.", +"One or more of the resources set to auto-delete could not be deleted because they were in use.", +"When a resource schema validation is ignored.", +"Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", +"When undeclared properties in the schema are present", +"A given scope cannot be reached." +], +"type": "string" +}, +"data": { +"description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", +"items": { +"properties": { +"key": { +"description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", +"type": "string" +}, +"value": { +"description": "[Output Only] A warning data value corresponding to the key.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +}, +"message": { +"description": "[Output Only] A human-readable description of the warning code.", +"type": "string" +} +}, +"type": "object" +} +}, +"type": "object" +}, "HealthAggregationPolicy": { "description": "Represents a health aggregation policy. A health aggregation policy resource defines a policy to aggregate health. For more information, see Health checks overview.", "id": "HealthAggregationPolicy", @@ -64562,6 +65680,169 @@ false }, "type": "object" }, +"HealthAggregationPolicyAggregatedList": { +"description": "Contains a list of HealthAggregationPoliciesScopedList.", +"id": "HealthAggregationPolicyAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "HealthAggregationPoliciesScopedList", +"description": "Name of the scope containing this set of HealthAggregationPolicies." +}, +"description": "A list of HealthAggregationPoliciesScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#healthAggregationPolicyAggregatedList", +"description": "Type of resource.", +"type": "string" +}, +"nextPageToken": { +"description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for this resource.", +"type": "string" +}, +"unreachables": { +"description": "[Output Only] Unreachable resources.", +"items": { +"type": "string" +}, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning message.", +"properties": { +"code": { +"description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", +"enum": [ +"CLEANUP_FAILED", +"DEPRECATED_RESOURCE_USED", +"DEPRECATED_TYPE_USED", +"DISK_SIZE_LARGER_THAN_IMAGE_SIZE", +"EXPERIMENTAL_TYPE_USED", +"EXTERNAL_API_WARNING", +"FIELD_VALUE_OVERRIDEN", +"INJECTED_KERNELS_DEPRECATED", +"INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", +"LARGE_DEPLOYMENT_WARNING", +"LIST_OVERHEAD_QUOTA_EXCEED", +"MISSING_TYPE_DEPENDENCY", +"NEXT_HOP_ADDRESS_NOT_ASSIGNED", +"NEXT_HOP_CANNOT_IP_FORWARD", +"NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", +"NEXT_HOP_INSTANCE_NOT_FOUND", +"NEXT_HOP_INSTANCE_NOT_ON_NETWORK", +"NEXT_HOP_NOT_RUNNING", +"NOT_CRITICAL_ERROR", +"NO_RESULTS_ON_PAGE", +"PARTIAL_SUCCESS", +"QUOTA_INFO_UNAVAILABLE", +"REQUIRED_TOS_AGREEMENT", +"RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", +"RESOURCE_NOT_DELETED", +"SCHEMA_VALIDATION_IGNORED", +"SINGLE_INSTANCE_PROPERTY_TEMPLATE", +"UNDECLARED_PROPERTIES", +"UNREACHABLE" +], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +true, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false +], +"enumDescriptions": [ +"Warning about failed cleanup of transient changes made by a failed operation.", +"A link to a deprecated resource was created.", +"When deploying and at least one of the resources has a type marked as deprecated", +"The user created a boot disk that is larger than image size.", +"When deploying and at least one of the resources has a type marked as experimental", +"Warning that is present in an external api call", +"Warning that value of a field has been overridden. Deprecated unused field.", +"The operation involved use of an injected kernel, which is deprecated.", +"A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", +"When deploying a deployment with a exceedingly large number of resources", +"Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", +"A resource depends on a missing type", +"The route's nextHopIp address is not assigned to an instance on the network.", +"The route's next hop instance cannot ip forward.", +"The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", +"The route's nextHopInstance URL refers to an instance that does not exist.", +"The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", +"The route's next hop instance does not have a status of RUNNING.", +"Error which is not critical. We decided to continue the process despite the mentioned error.", +"No results are present on a particular list page.", +"Success is reported, but some results may be missing due to errors", +"Quota information is not available to client requests (e.g: regions.list).", +"The user attempted to use a resource that requires a TOS they have not accepted.", +"Warning that a resource is in use.", +"One or more of the resources set to auto-delete could not be deleted because they were in use.", +"When a resource schema validation is ignored.", +"Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", +"When undeclared properties in the schema are present", +"A given scope cannot be reached." +], +"type": "string" +}, +"data": { +"description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", +"items": { +"properties": { +"key": { +"description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", +"type": "string" +}, +"value": { +"description": "[Output Only] A warning data value corresponding to the key.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +}, +"message": { +"description": "[Output Only] A human-readable description of the warning code.", +"type": "string" +} +}, +"type": "object" +} +}, +"type": "object" +}, "HealthAggregationPolicyList": { "id": "HealthAggregationPolicyList", "properties": { @@ -80605,6 +81886,13 @@ false "MultiMigStatus": { "id": "MultiMigStatus", "properties": { +"appliedAcceleratorTopologies": { +"description": "[Output Only] The accelerator topology applied to this multi-MIG. Currently only one accelerator topology is supported.", +"items": { +"$ref": "MultiMigStatusAcceleratorTopology" +}, +"type": "array" +}, "memberInstanceGroupManagers": { "items": { "type": "string" @@ -80619,6 +81907,99 @@ false }, "type": "object" }, +"MultiMigStatusAcceleratorTopology": { +"id": "MultiMigStatusAcceleratorTopology", +"properties": { +"acceleratorTopology": { +"description": "[Output Only] Topology in the format of: \"16x16\", \"4x4x4\", etc. The value is the same as configured in the WorkloadPolicy.", +"type": "string" +}, +"acceleratorTopologyState": { +"description": "[Output Only] The state of the accelerator topology.", +"enum": [ +"ACTIVATING", +"ACTIVE", +"ACTIVE_DEGRADED", +"DEACTIVATING", +"FAILED", +"INCOMPLETE" +], +"enumDescriptions": [ +"The accelerator topology is being activated.", +"The accelerator topology is active.", +"The accelerator topology is active but operating in degraded mode.", +"The accelerator topology is being deactivated.", +"The accelerator topology failed.", +"The configuration is incomplete and the accelerator topology cannot be activated due to insufficient number of running VMs." +], +"type": "string" +}, +"acceleratorTopologyStateLastCheck": { +"$ref": "MultiMigStatusAcceleratorTopologyAcceleratorTopologyStateLastCheck", +"description": "[Output Only] The result of the latest accelerator topology state check." +} +}, +"type": "object" +}, +"MultiMigStatusAcceleratorTopologyAcceleratorTopologyStateLastCheck": { +"id": "MultiMigStatusAcceleratorTopologyAcceleratorTopologyStateLastCheck", +"properties": { +"error": { +"description": "[Output Only] Encountered errors on the last state check.", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this operation.", +"items": { +"properties": { +"code": { +"description": "[Output Only] The error type identifier for this error.", +"type": "string" +}, +"errorDetails": { +"description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", +"items": { +"properties": { +"errorInfo": { +"$ref": "ErrorInfo" +}, +"help": { +"$ref": "Help" +}, +"localizedMessage": { +"$ref": "LocalizedMessage" +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo" +} +}, +"type": "object" +}, +"type": "array" +}, +"location": { +"description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", +"type": "string" +}, +"message": { +"description": "[Output Only] An optional, human-readable error message.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +} +}, +"type": "object" +}, +"timestamp": { +"description": "[Output Only] Timestamp is shown only if there is an error. The field has // RFC3339 // text format.", +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, "MultiMigsList": { "id": "MultiMigsList", "properties": { @@ -83899,6 +85280,18 @@ false ], "type": "string" }, +"allowFirewallPolicy": { +"description": "Specifies whether firewall policy can be attached to the network.", +"enum": [ +"FIREWALL_POLICY_ALLOWED", +"FIREWALL_POLICY_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, "allowInterconnect": { "description": "Specifies whether Cloud Interconnect creation is allowed.", "enum": [ @@ -84043,6 +85436,18 @@ false ], "type": "string" }, +"allowVpcFirewallRules": { +"description": "Specifies whether VPC firewall rules can be created under the network.", +"enum": [ +"VPC_FIREWALL_RULES_ALLOWED", +"VPC_FIREWALL_RULES_BLOCKED" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, "allowVpcPeering": { "description": "Specifies whether VPC peering is allowed.", "enum": [ @@ -84067,6 +85472,20 @@ false ], "type": "string" }, +"firewallPolicyTypes": { +"items": { +"enum": [ +"RDMA_ROCE_POLICY", +"VPC_POLICY" +], +"enumDescriptions": [ +"", +"" +], +"type": "string" +}, +"type": "array" +}, "interfaceTypes": { "description": "If set, limits the interface types that the network supports. If empty, all interface types are supported.", "items": { @@ -95336,6 +96755,11 @@ false "format": "int32", "type": "integer" }, +"inUseHostCount": { +"description": "Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use.", +"format": "int32", +"type": "integer" +}, "kind": { "default": "compute#reservationBlock", "description": "[Output Only] Type of the resource. Always compute#reservationBlock for reservation blocks.", @@ -95805,303 +97229,374 @@ false }, "type": "object" }, -"ReservationSubBlock": { -"description": "Represents a reservation subBlock resource.", -"id": "ReservationSubBlock", +"ReservationSubBlock": { +"description": "Represents a reservation subBlock resource.", +"id": "ReservationSubBlock", +"properties": { +"count": { +"description": "[Output Only] The number of hosts that are allocated in this reservation subBlock.", +"format": "int32", +"type": "integer" +}, +"creationTimestamp": { +"description": "[Output Only] Creation timestamp in RFC3339 text format.", +"type": "string" +}, +"healthInfo": { +"$ref": "ReservationSubBlockHealthInfo", +"description": "[Output Only] Health information for the reservation subBlock." +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", +"format": "uint64", +"type": "string" +}, +"inUseCount": { +"description": "[Output Only] The number of instances that are currently in use on this reservation subBlock.", +"format": "int32", +"type": "integer" +}, +"inUseHostCount": { +"description": "Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use.", +"format": "int32", +"type": "integer" +}, +"kind": { +"default": "compute#reservationSubBlock", +"description": "[Output Only] Type of the resource. Always compute#reservationSubBlock for reservation subBlocks.", +"type": "string" +}, +"name": { +"description": "[Output Only] The name of this reservation subBlock generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"physicalTopology": { +"$ref": "ReservationSubBlockPhysicalTopology", +"description": "[Output Only] The physical topology of the reservation subBlock." +}, +"reservationSubBlockMaintenance": { +"$ref": "GroupMaintenanceInfo", +"description": "Maintenance information for this reservation subBlock." +}, +"selfLink": { +"description": "[Output Only] Server-defined fully-qualified URL for this resource.", +"type": "string" +}, +"selfLinkWithId": { +"description": "[Output Only] Server-defined URL for this resource with the resource id.", +"type": "string" +}, +"status": { +"description": "[Output Only] Status of the reservation subBlock.", +"enum": [ +"CREATING", +"DELETING", +"INVALID", +"READY" +], +"enumDescriptions": [ +"Resources are being allocated for the reservation subBlock.", +"Reservation subBlock is currently being deleted.", +"", +"Reservation subBlock has allocated all its resources." +], +"type": "string" +}, +"zone": { +"description": "[Output Only] Zone in which the reservation subBlock resides.", +"type": "string" +} +}, +"type": "object" +}, +"ReservationSubBlockHealthInfo": { +"description": "Health information for the reservation subBlock.", +"id": "ReservationSubBlockHealthInfo", +"properties": { +"degradedHostCount": { +"description": "The number of degraded hosts in the reservation subBlock.", +"format": "int32", +"type": "integer" +}, +"degradedInfraCount": { +"description": "The number of degraded infrastructure (e.g NV link domain) in the reservation subblock.", +"format": "int32", +"type": "integer" +}, +"healthStatus": { +"description": "The health status of the reservation subBlock.", +"enum": [ +"DEGRADED", +"HEALTHY", +"HEALTH_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"The reservation subBlock is degraded.", +"The reservation subBlock is healthy.", +"The health status of the reservation subBlock is unspecified." +], +"type": "string" +}, +"healthyHostCount": { +"description": "The number of healthy hosts in the reservation subBlock.", +"format": "int32", +"type": "integer" +}, +"healthyInfraCount": { +"description": "The number of healthy infrastructure (e.g NV link domain) in the reservation subblock.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"ReservationSubBlockPhysicalTopology": { +"id": "ReservationSubBlockPhysicalTopology", +"properties": { +"block": { +"description": "The hash of the capacity block within the cluster.", +"type": "string" +}, +"cluster": { +"description": "The cluster name of the reservation subBlock.", +"type": "string" +}, +"subBlock": { +"description": "The hash of the capacity sub-block within the capacity block.", +"type": "string" +} +}, +"type": "object" +}, +"ReservationSubBlocksGetResponse": { +"id": "ReservationSubBlocksGetResponse", +"properties": { +"resource": { +"$ref": "ReservationSubBlock" +} +}, +"type": "object" +}, +"ReservationSubBlocksListResponse": { +"description": "A list of reservation subBlocks under a single reservation.", +"id": "ReservationSubBlocksListResponse", +"properties": { +"id": { +"description": "Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of reservation subBlock resources.", +"items": { +"$ref": "ReservationSubBlock" +}, +"type": "array" +}, +"kind": { +"default": "compute#reservationSubBlock", +"description": "Type of the resource. Always compute#reservationSubBlock for a list of reservation subBlocks.", +"type": "string" +}, +"nextPageToken": { +"description": "This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", +"type": "string" +}, +"selfLink": { +"description": "Server-defined URL for this resource.", +"type": "string" +}, +"warning": { +"description": "Informational warning message.", +"properties": { +"code": { +"description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", +"enum": [ +"CLEANUP_FAILED", +"DEPRECATED_RESOURCE_USED", +"DEPRECATED_TYPE_USED", +"DISK_SIZE_LARGER_THAN_IMAGE_SIZE", +"EXPERIMENTAL_TYPE_USED", +"EXTERNAL_API_WARNING", +"FIELD_VALUE_OVERRIDEN", +"INJECTED_KERNELS_DEPRECATED", +"INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", +"LARGE_DEPLOYMENT_WARNING", +"LIST_OVERHEAD_QUOTA_EXCEED", +"MISSING_TYPE_DEPENDENCY", +"NEXT_HOP_ADDRESS_NOT_ASSIGNED", +"NEXT_HOP_CANNOT_IP_FORWARD", +"NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", +"NEXT_HOP_INSTANCE_NOT_FOUND", +"NEXT_HOP_INSTANCE_NOT_ON_NETWORK", +"NEXT_HOP_NOT_RUNNING", +"NOT_CRITICAL_ERROR", +"NO_RESULTS_ON_PAGE", +"PARTIAL_SUCCESS", +"QUOTA_INFO_UNAVAILABLE", +"REQUIRED_TOS_AGREEMENT", +"RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", +"RESOURCE_NOT_DELETED", +"SCHEMA_VALIDATION_IGNORED", +"SINGLE_INSTANCE_PROPERTY_TEMPLATE", +"UNDECLARED_PROPERTIES", +"UNREACHABLE" +], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +true, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false +], +"enumDescriptions": [ +"Warning about failed cleanup of transient changes made by a failed operation.", +"A link to a deprecated resource was created.", +"When deploying and at least one of the resources has a type marked as deprecated", +"The user created a boot disk that is larger than image size.", +"When deploying and at least one of the resources has a type marked as experimental", +"Warning that is present in an external api call", +"Warning that value of a field has been overridden. Deprecated unused field.", +"The operation involved use of an injected kernel, which is deprecated.", +"A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", +"When deploying a deployment with a exceedingly large number of resources", +"Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", +"A resource depends on a missing type", +"The route's nextHopIp address is not assigned to an instance on the network.", +"The route's next hop instance cannot ip forward.", +"The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", +"The route's nextHopInstance URL refers to an instance that does not exist.", +"The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", +"The route's next hop instance does not have a status of RUNNING.", +"Error which is not critical. We decided to continue the process despite the mentioned error.", +"No results are present on a particular list page.", +"Success is reported, but some results may be missing due to errors", +"Quota information is not available to client requests (e.g: regions.list).", +"The user attempted to use a resource that requires a TOS they have not accepted.", +"Warning that a resource is in use.", +"One or more of the resources set to auto-delete could not be deleted because they were in use.", +"When a resource schema validation is ignored.", +"Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", +"When undeclared properties in the schema are present", +"A given scope cannot be reached." +], +"type": "string" +}, +"data": { +"description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", +"items": { +"properties": { +"key": { +"description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", +"type": "string" +}, +"value": { +"description": "[Output Only] A warning data value corresponding to the key.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +}, +"message": { +"description": "[Output Only] A human-readable description of the warning code.", +"type": "string" +} +}, +"type": "object" +} +}, +"type": "object" +}, +"ReservationSubBlocksReportFaultyRequest": { +"id": "ReservationSubBlocksReportFaultyRequest", "properties": { -"count": { -"description": "[Output Only] The number of hosts that are allocated in this reservation subBlock.", -"format": "int32", -"type": "integer" -}, -"creationTimestamp": { -"description": "[Output Only] Creation timestamp in RFC3339 text format.", -"type": "string" -}, -"healthInfo": { -"$ref": "ReservationSubBlockHealthInfo", -"description": "[Output Only] Health information for the reservation subBlock." -}, -"id": { -"description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", -"format": "uint64", -"type": "string" -}, -"inUseCount": { -"description": "[Output Only] The number of instances that are currently in use on this reservation subBlock.", -"format": "int32", -"type": "integer" -}, -"kind": { -"default": "compute#reservationSubBlock", -"description": "[Output Only] Type of the resource. Always compute#reservationSubBlock for reservation subBlocks.", -"type": "string" -}, -"name": { -"description": "[Output Only] The name of this reservation subBlock generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", -"type": "string" -}, -"physicalTopology": { -"$ref": "ReservationSubBlockPhysicalTopology", -"description": "[Output Only] The physical topology of the reservation subBlock." -}, -"reservationSubBlockMaintenance": { -"$ref": "GroupMaintenanceInfo", -"description": "Maintenance information for this reservation subBlock." -}, -"selfLink": { -"description": "[Output Only] Server-defined fully-qualified URL for this resource.", -"type": "string" -}, -"selfLinkWithId": { -"description": "[Output Only] Server-defined URL for this resource with the resource id.", -"type": "string" -}, -"status": { -"description": "[Output Only] Status of the reservation subBlock.", +"disruptionSchedule": { +"description": "The disruption schedule for the subBlock.", "enum": [ -"CREATING", -"DELETING", -"INVALID", -"READY" +"DISRUPTION_SCHEDULE_UNSPECIFIED", +"IMMEDIATE" ], "enumDescriptions": [ -"Resources are being allocated for the reservation subBlock.", -"Reservation subBlock is currently being deleted.", "", -"Reservation subBlock has allocated all its resources." +"All VMs will be disrupted immediately." ], "type": "string" }, -"zone": { -"description": "[Output Only] Zone in which the reservation subBlock resides.", -"type": "string" -} -}, -"type": "object" -}, -"ReservationSubBlockHealthInfo": { -"description": "Health information for the reservation subBlock.", -"id": "ReservationSubBlockHealthInfo", -"properties": { -"degradedHostCount": { -"description": "The number of degraded hosts in the reservation subBlock.", -"format": "int32", -"type": "integer" -}, -"degradedInfraCount": { -"description": "The number of degraded infrastructure (e.g NV link domain) in the reservation subblock.", -"format": "int32", -"type": "integer" -}, -"healthStatus": { -"description": "The health status of the reservation subBlock.", +"failureComponent": { +"description": "The component that experienced the fault.", "enum": [ -"DEGRADED", -"HEALTHY", -"HEALTH_STATUS_UNSPECIFIED" +"FAILURE_COMPONENT_UNSPECIFIED", +"MULTIPLE_FAULTY_HOSTS", +"NVLINK_SWITCH" ], "enumDescriptions": [ -"The reservation subBlock is degraded.", -"The reservation subBlock is healthy.", -"The health status of the reservation subBlock is unspecified." +"", +"Multiple hosts experienced the fault.", +"The NVLink switch experienced the fault." ], "type": "string" }, -"healthyHostCount": { -"description": "The number of healthy hosts in the reservation subBlock.", -"format": "int32", -"type": "integer" -}, -"healthyInfraCount": { -"description": "The number of healthy infrastructure (e.g NV link domain) in the reservation subblock.", -"format": "int32", -"type": "integer" -} -}, -"type": "object" -}, -"ReservationSubBlockPhysicalTopology": { -"id": "ReservationSubBlockPhysicalTopology", -"properties": { -"block": { -"description": "The hash of the capacity block within the cluster.", -"type": "string" -}, -"cluster": { -"description": "The cluster name of the reservation subBlock.", -"type": "string" -}, -"subBlock": { -"description": "The hash of the capacity sub-block within the capacity block.", -"type": "string" -} -}, -"type": "object" -}, -"ReservationSubBlocksGetResponse": { -"id": "ReservationSubBlocksGetResponse", -"properties": { -"resource": { -"$ref": "ReservationSubBlock" -} -}, -"type": "object" -}, -"ReservationSubBlocksListResponse": { -"description": "A list of reservation subBlocks under a single reservation.", -"id": "ReservationSubBlocksListResponse", -"properties": { -"id": { -"description": "Unique identifier for the resource; defined by the server.", -"type": "string" -}, -"items": { -"description": "A list of reservation subBlock resources.", +"faultReasons": { +"description": "The reasons for the fault experienced with the subBlock.", "items": { -"$ref": "ReservationSubBlock" +"$ref": "ReservationSubBlocksReportFaultyRequestFaultReason" }, "type": "array" +} }, -"kind": { -"default": "compute#reservationSubBlock", -"description": "Type of the resource. Always compute#reservationSubBlock for a list of reservation subBlocks.", -"type": "string" -}, -"nextPageToken": { -"description": "This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", -"type": "string" -}, -"selfLink": { -"description": "Server-defined URL for this resource.", -"type": "string" +"type": "object" }, -"warning": { -"description": "Informational warning message.", +"ReservationSubBlocksReportFaultyRequestFaultReason": { +"description": "The reason for the fault experienced with the subBlock.", +"id": "ReservationSubBlocksReportFaultyRequestFaultReason", "properties": { -"code": { -"description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", +"behavior": { +"description": "The behavior of the fault experienced with the subBlock.", "enum": [ -"CLEANUP_FAILED", -"DEPRECATED_RESOURCE_USED", -"DEPRECATED_TYPE_USED", -"DISK_SIZE_LARGER_THAN_IMAGE_SIZE", -"EXPERIMENTAL_TYPE_USED", -"EXTERNAL_API_WARNING", -"FIELD_VALUE_OVERRIDEN", -"INJECTED_KERNELS_DEPRECATED", -"INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", -"LARGE_DEPLOYMENT_WARNING", -"LIST_OVERHEAD_QUOTA_EXCEED", -"MISSING_TYPE_DEPENDENCY", -"NEXT_HOP_ADDRESS_NOT_ASSIGNED", -"NEXT_HOP_CANNOT_IP_FORWARD", -"NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", -"NEXT_HOP_INSTANCE_NOT_FOUND", -"NEXT_HOP_INSTANCE_NOT_ON_NETWORK", -"NEXT_HOP_NOT_RUNNING", -"NOT_CRITICAL_ERROR", -"NO_RESULTS_ON_PAGE", -"PARTIAL_SUCCESS", -"QUOTA_INFO_UNAVAILABLE", -"REQUIRED_TOS_AGREEMENT", -"RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", -"RESOURCE_NOT_DELETED", -"SCHEMA_VALIDATION_IGNORED", -"SINGLE_INSTANCE_PROPERTY_TEMPLATE", -"UNDECLARED_PROPERTIES", -"UNREACHABLE" -], -"enumDeprecated": [ -false, -false, -false, -false, -false, -false, -true, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false, -false +"FAULT_BEHAVIOR_UNSPECIFIED", +"GPU_ERROR", +"PERFORMANCE", +"SWITCH_FAILURE" ], "enumDescriptions": [ -"Warning about failed cleanup of transient changes made by a failed operation.", -"A link to a deprecated resource was created.", -"When deploying and at least one of the resources has a type marked as deprecated", -"The user created a boot disk that is larger than image size.", -"When deploying and at least one of the resources has a type marked as experimental", -"Warning that is present in an external api call", -"Warning that value of a field has been overridden. Deprecated unused field.", -"The operation involved use of an injected kernel, which is deprecated.", -"A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", -"When deploying a deployment with a exceedingly large number of resources", -"Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", -"A resource depends on a missing type", -"The route's nextHopIp address is not assigned to an instance on the network.", -"The route's next hop instance cannot ip forward.", -"The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", -"The route's nextHopInstance URL refers to an instance that does not exist.", -"The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", -"The route's next hop instance does not have a status of RUNNING.", -"Error which is not critical. We decided to continue the process despite the mentioned error.", -"No results are present on a particular list page.", -"Success is reported, but some results may be missing due to errors", -"Quota information is not available to client requests (e.g: regions.list).", -"The user attempted to use a resource that requires a TOS they have not accepted.", -"Warning that a resource is in use.", -"One or more of the resources set to auto-delete could not be deleted because they were in use.", -"When a resource schema validation is ignored.", -"Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", -"When undeclared properties in the schema are present", -"A given scope cannot be reached." +"", +"The subBlock experienced a GPU error.", +"The subBlock experienced performance issues.", +"The subBlock experienced a switch failure." ], "type": "string" }, -"data": { -"description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", -"items": { -"properties": { -"key": { -"description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", -"type": "string" -}, -"value": { -"description": "[Output Only] A warning data value corresponding to the key.", -"type": "string" -} -}, -"type": "object" -}, -"type": "array" -}, -"message": { -"description": "[Output Only] A human-readable description of the warning code.", +"description": { +"description": "The description of the fault experienced with the subBlock.", "type": "string" } }, "type": "object" -} -}, -"type": "object" }, "ReservationsBlocksPerformMaintenanceRequest": { "id": "ReservationsBlocksPerformMaintenanceRequest", @@ -96561,7 +98056,8 @@ false "description": "Resource policy applicable to VMs for infrastructure maintenance." }, "workloadPolicy": { -"$ref": "ResourcePolicyWorkloadPolicy" +"$ref": "ResourcePolicyWorkloadPolicy", +"description": "Resource policy for defining instance placement for MIGs." } }, "type": "object" @@ -97260,9 +98756,11 @@ false "id": "ResourcePolicyWorkloadPolicy", "properties": { "acceleratorTopology": { +"description": "Specifies the topology required to create a partition for VMs that have interconnected GPUs.", "type": "string" }, "maxTopologyDistance": { +"description": "Specifies the maximum distance between instances.", "enum": [ "BLOCK", "CLUSTER", @@ -97276,13 +98774,14 @@ false "type": "string" }, "type": { +"description": "Specifies the intent of the instance placement in the MIG.", "enum": [ "HIGH_AVAILABILITY", "HIGH_THROUGHPUT" ], "enumDescriptions": [ -"VMs will be provisioned in such a way which provides high availability.", -"VMs will be provisioned in such a way which provides high throughput." +"MIG spreads out the instances as much as possible for high availability.", +"MIG provisions instances as close to each other as possible for high throughput." ], "type": "string" } @@ -97301,10 +98800,12 @@ false "type": "array" }, "consumedReservation": { +"deprecated": true, "description": "[Output Only] The full resource name of the reservation that this instance is consuming from.", "type": "string" }, "consumedReservationBlock": { +"deprecated": true, "description": "[Output Only] The full resource name of the reservation block that this instance is consuming from.", "type": "string" }, @@ -112151,6 +113652,10 @@ false "description": "URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created.", "type": "string" }, +"params": { +"$ref": "TargetVpnGatewayParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload." +}, "region": { "description": "[Output Only] URL of the region where the target VPN gateway resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", "type": "string" @@ -112502,6 +114007,19 @@ false }, "type": "object" }, +"TargetVpnGatewayParams": { +"id": "TargetVpnGatewayParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"} * {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {\"123/environment\" : \"tagValues/444\"} is invalid. * Inconsistent format is not supported. For instance: {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", +"type": "object" +} +}, +"type": "object" +}, "TargetVpnGatewaysScopedList": { "id": "TargetVpnGatewaysScopedList", "properties": { @@ -114553,6 +116071,10 @@ false "description": "URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created.", "type": "string" }, +"params": { +"$ref": "VpnGatewayParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload." +}, "region": { "description": "[Output Only] URL of the region where the VPN gateway resides.", "type": "string" @@ -114902,6 +116424,19 @@ false }, "type": "object" }, +"VpnGatewayParams": { +"id": "VpnGatewayParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"} * {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {\"123/environment\" : \"tagValues/444\"} is invalid. * Inconsistent format is not supported. For instance: {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", +"type": "object" +} +}, +"type": "object" +}, "VpnGatewayStatus": { "id": "VpnGatewayStatus", "properties": { @@ -115225,6 +116760,10 @@ false "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, +"params": { +"$ref": "VpnTunnelParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload." +}, "peerExternalGateway": { "description": "URL of the peer side external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field is exclusive with the field peerGcpGateway.", "type": "string" @@ -115648,6 +117187,19 @@ false }, "type": "object" }, +"VpnTunnelParams": { +"id": "VpnTunnelParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"} * {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {\"123/environment\" : \"tagValues/444\"} is invalid. * Inconsistent format is not supported. For instance: {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", +"type": "object" +} +}, +"type": "object" +}, "VpnTunnelPhase1Algorithms": { "id": "VpnTunnelPhase1Algorithms", "properties": { diff --git a/googleapiclient/discovery_cache/documents/compute.beta.json b/googleapiclient/discovery_cache/documents/compute.beta.json index 27985811960..4602d8067aa 100644 --- a/googleapiclient/discovery_cache/documents/compute.beta.json +++ b/googleapiclient/discovery_cache/documents/compute.beta.json @@ -45747,7 +45747,7 @@ } } }, -"revision": "20250728", +"revision": "20250729", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -48471,12 +48471,14 @@ false "enum": [ "CONNECTION", "CUSTOM_METRICS", +"IN_FLIGHT", "RATE", "UTILIZATION" ], "enumDescriptions": [ "Balance based on the number of simultaneous connections.", "Based on custom defined and reported metrics.", +"Balance based on the number of in-flight requests.", "Balance based on requests per second (RPS).", "Balance based on the backend utilization." ], @@ -48521,6 +48523,21 @@ false "format": "int32", "type": "integer" }, +"maxInFlightRequests": { +"description": "Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode is RATE or CONNECTION.", +"format": "int32", +"type": "integer" +}, +"maxInFlightRequestsPerEndpoint": { +"description": "Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION.", +"format": "int32", +"type": "integer" +}, +"maxInFlightRequestsPerInstance": { +"description": "Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION.", +"format": "int32", +"type": "integer" +}, "maxRate": { "description": "Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.", "format": "int32", @@ -48554,6 +48571,19 @@ false "Traffic will be sent to this backend first." ], "type": "string" +}, +"trafficDuration": { +"enum": [ +"LONG", +"SHORT", +"TRAFFIC_DURATION_UNSPECIFIED" +], +"enumDescriptions": [ +"Most of the requests are expected to take more than multiple seconds to finish.", +"Most requests are expected to finish with a sub-second latency.", +"Traffic duration is unspecified." +], +"type": "string" } }, "type": "object" @@ -70823,6 +70853,10 @@ false "$ref": "ManagedInstancePropertiesFromFlexibilityPolicy", "description": "[Output Only] Instance properties selected for this instance resulting from InstanceFlexibilityPolicy." }, +"scheduling": { +"$ref": "ManagedInstanceScheduling", +"description": "[Output Only] Information about the termination timestamp of the instance, if applicable." +}, "targetStatus": { "description": "[Output Only] The eventual status of the instance. The instance group manager will not be identified as stable till each managed instance reaches its targetStatus.", "enum": [ @@ -70966,6 +71000,17 @@ false }, "type": "object" }, +"ManagedInstanceScheduling": { +"id": "ManagedInstanceScheduling", +"properties": { +"terminationTimestamp": { +"description": "[Output Only] The timestamp at which the managed instance will be terminated. This is in RFC3339 text format.", +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, "ManagedInstanceVersion": { "id": "ManagedInstanceVersion", "properties": { @@ -82910,6 +82955,10 @@ false "description": "Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.", "id": "Reservation", "properties": { +"advancedDeploymentControl": { +"$ref": "ReservationAdvancedDeploymentControl", +"description": "Advanced control for cluster management, applicable only to DENSE deployment type reservations." +}, "aggregateReservation": { "$ref": "AllocationAggregateReservation", "description": "Reservation for aggregated resources, providing shape flexibility." @@ -83081,6 +83130,27 @@ false }, "type": "object" }, +"ReservationAdvancedDeploymentControl": { +"description": "Advance control for cluster management, applicable only to DENSE deployment type reservations.", +"id": "ReservationAdvancedDeploymentControl", +"properties": { +"reservationOperationalMode": { +"description": "Indicates chosen reservation operational mode for the reservation.", +"enum": [ +"ALL_CAPACITY", +"HIGHLY_AVAILABLE_CAPACITY", +"RESERVATION_OPERATIONAL_MODE_UNSPECIFIED" +], +"enumDescriptions": [ +"Google Cloud does not manage the failure of machines, but provides additional capacity, which is not guaranteed to be available.", +"Google Cloud manages the failure of machines to provide high availability.", +"" +], +"type": "string" +} +}, +"type": "object" +}, "ReservationAffinity": { "description": "Specifies the reservations that this instance can consume from.", "id": "ReservationAffinity", @@ -84521,7 +84591,8 @@ false "type": "string" }, "workloadPolicy": { -"$ref": "ResourcePolicyWorkloadPolicy" +"$ref": "ResourcePolicyWorkloadPolicy", +"description": "Resource policy for defining instance placement for MIGs." } }, "type": "object" @@ -85156,9 +85227,11 @@ false "id": "ResourcePolicyWorkloadPolicy", "properties": { "acceleratorTopology": { +"description": "Specifies the topology required to create a partition for VMs that have interconnected GPUs.", "type": "string" }, "maxTopologyDistance": { +"description": "Specifies the maximum distance between instances.", "enum": [ "BLOCK", "CLUSTER", @@ -85172,13 +85245,14 @@ false "type": "string" }, "type": { +"description": "Specifies the intent of the instance placement in the MIG.", "enum": [ "HIGH_AVAILABILITY", "HIGH_THROUGHPUT" ], "enumDescriptions": [ -"VMs will be provisioned in such a way which provides high availability.", -"VMs will be provisioned in such a way which provides high throughput." +"MIG spreads out the instances as much as possible for high availability.", +"MIG provisions instances as close to each other as possible for high throughput." ], "type": "string" } diff --git a/googleapiclient/discovery_cache/documents/compute.v1.json b/googleapiclient/discovery_cache/documents/compute.v1.json index c4b9f7f4c86..75fe5df52f0 100644 --- a/googleapiclient/discovery_cache/documents/compute.v1.json +++ b/googleapiclient/discovery_cache/documents/compute.v1.json @@ -18178,6 +18178,48 @@ "https://www.googleapis.com/auth/compute" ] }, +"requestRemovePeering": { +"description": "Requests to remove a peering from the specified network. Applicable only for PeeringConnection with update_strategy=CONSENSUS.", +"flatPath": "projects/{project}/global/networks/{network}/requestRemovePeering", +"httpMethod": "POST", +"id": "compute.networks.requestRemovePeering", +"parameterOrder": [ +"project", +"network" +], +"parameters": { +"network": { +"description": "Name of the network resource to remove peering from.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/networks/{network}/requestRemovePeering", +"request": { +"$ref": "NetworksRequestRemovePeeringRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, "switchToCustomMode": { "description": "Switches the network mode from auto subnet mode to custom subnet mode.", "flatPath": "projects/{project}/global/networks/{network}/switchToCustomMode", @@ -39954,7 +39996,7 @@ } } }, -"revision": "20250728", +"revision": "20250729", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -42771,6 +42813,10 @@ false "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, +"params": { +"$ref": "BackendBucketParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload." +}, "selfLink": { "description": "[Output Only] Server-defined URL for the resource.", "type": "string" @@ -43070,6 +43116,20 @@ false }, "type": "object" }, +"BackendBucketParams": { +"description": "Additional Backend Bucket parameters.", +"id": "BackendBucketParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"} * {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", +"type": "object" +} +}, +"type": "object" +}, "BackendBucketUsedBy": { "id": "BackendBucketUsedBy", "properties": { @@ -43334,6 +43394,10 @@ false "$ref": "OutlierDetection", "description": "Settings controlling the ejection of unhealthy backend endpoints from the load balancing pool of each individual proxy instance that processes the traffic for the given backend service. If not set, this feature is considered disabled. Results of the outlier detection algorithm (ejection of endpoints from the load balancing pool and returning them back to the pool) are executed independently by each proxy instance of the load balancer. In most cases, more than one proxy instance handles the traffic received by a backend service. Thus, it is possible that an unhealthy endpoint is detected and ejected by only some of the proxies, and while this happens, other proxies may continue to send requests to the same unhealthy endpoint until they detect and eject the unhealthy endpoint. Applicable backend endpoints can be: - VM instances in an Instance Group - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT) - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT) - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud Functions Services - Private Service Connect NEGs, that resolve to Google-managed regional API endpoints or managed services published using Private Service Connect Applicable backend service types can be: - A global backend service with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. - A regional backend service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not supported for Serverless NEGs. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true." }, +"params": { +"$ref": "BackendServiceParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload." +}, "port": { "deprecated": true, "description": "Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port.", @@ -44322,6 +44386,20 @@ false }, "type": "object" }, +"BackendServiceParams": { +"description": "Additional Backend Service parameters.", +"id": "BackendServiceParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"} * {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", +"type": "object" +} +}, +"type": "object" +}, "BackendServiceReference": { "id": "BackendServiceReference", "properties": { @@ -57691,10 +57769,18 @@ false "description": "Represents an Interconnect resource. An Interconnect resource is a dedicated connection between the Google Cloud network and your on-premises network. For more information, read the Dedicated Interconnect Overview.", "id": "Interconnect", "properties": { +"aaiEnabled": { +"description": "Enable or disable the application awareness feature on this Cloud Interconnect.", +"type": "boolean" +}, "adminEnabled": { "description": "Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true.", "type": "boolean" }, +"applicationAwareInterconnect": { +"$ref": "InterconnectApplicationAwareInterconnect", +"description": "Configuration information for application awareness on this Cloud Interconnect." +}, "availableFeatures": { "description": "[Output only] List of features available for this Interconnect connection, which can take one of the following values: - IF_MACSEC If present then the Interconnect connection is provisioned on MACsec capable hardware ports. If not present then the Interconnect connection is provisioned on non-MACsec capable ports and MACsec isn't supported and enabling MACsec fails.", "items": { @@ -57898,6 +57984,81 @@ false }, "type": "object" }, +"InterconnectApplicationAwareInterconnect": { +"description": "Configuration information for application awareness on this Cloud Interconnect.", +"id": "InterconnectApplicationAwareInterconnect", +"properties": { +"bandwidthPercentagePolicy": { +"$ref": "InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy" +}, +"profileDescription": { +"description": "Description for the application awareness profile on this Cloud Interconnect.", +"type": "string" +}, +"shapeAveragePercentages": { +"description": "Optional field to specify a list of shape average percentages to be applied in conjunction with StrictPriorityPolicy or BandwidthPercentagePolicy.", +"items": { +"$ref": "InterconnectApplicationAwareInterconnectBandwidthPercentage" +}, +"type": "array" +}, +"strictPriorityPolicy": { +"$ref": "InterconnectApplicationAwareInterconnectStrictPriorityPolicy" +} +}, +"type": "object" +}, +"InterconnectApplicationAwareInterconnectBandwidthPercentage": { +"description": "Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified.", +"id": "InterconnectApplicationAwareInterconnectBandwidthPercentage", +"properties": { +"percentage": { +"description": "Bandwidth percentage for a specific traffic class.", +"format": "uint32", +"type": "integer" +}, +"trafficClass": { +"description": "TrafficClass whose bandwidth percentage is being specified.", +"enum": [ +"TC1", +"TC2", +"TC3", +"TC4", +"TC5", +"TC6" +], +"enumDescriptions": [ +"Traffic Class 1, corresponding to DSCP ranges (0-7) 000xxx.", +"Traffic Class 2, corresponding to DSCP ranges (8-15) 001xxx.", +"Traffic Class 3, corresponding to DSCP ranges (16-23) 010xxx.", +"Traffic Class 4, corresponding to DSCP ranges (24-31) 011xxx.", +"Traffic Class 5, corresponding to DSCP ranges (32-47) 10xxxx.", +"Traffic Class 6, corresponding to DSCP ranges (48-63) 11xxxx." +], +"type": "string" +} +}, +"type": "object" +}, +"InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy": { +"id": "InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy", +"properties": { +"bandwidthPercentages": { +"description": "Specify bandwidth percentages for various traffic classes for queuing type Bandwidth Percent.", +"items": { +"$ref": "InterconnectApplicationAwareInterconnectBandwidthPercentage" +}, +"type": "array" +} +}, +"type": "object" +}, +"InterconnectApplicationAwareInterconnectStrictPriorityPolicy": { +"description": "Specify configuration for StrictPriorityPolicy.", +"id": "InterconnectApplicationAwareInterconnectStrictPriorityPolicy", +"properties": {}, +"type": "object" +}, "InterconnectAttachment": { "description": "Represents an Interconnect Attachment (VLAN) resource. You can use Interconnect attachments (VLANS) to connect your Virtual Private Cloud networks to your on-premises networks through an Interconnect. For more information, read Creating VLAN Attachments.", "id": "InterconnectAttachment", @@ -65207,6 +65368,10 @@ false "description": "This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE.", "type": "boolean" }, +"connectionStatus": { +"$ref": "NetworkPeeringConnectionStatus", +"description": "[Output Only] The effective state of the peering connection as a whole." +}, "exchangeSubnetRoutes": { "description": "Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE.", "type": "boolean" @@ -65267,6 +65432,122 @@ false "stateDetails": { "description": "[Output Only] Details about the current state of the peering.", "type": "string" +}, +"updateStrategy": { +"description": "The update strategy determines the semantics for updates and deletes to the peering connection configuration.", +"enum": [ +"CONSENSUS", +"INDEPENDENT", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Updates are reflected in the local peering but aren't applied to the peering connection until a complementary change is made to the matching peering. To delete a peering with the consensus update strategy, both the peerings must request the deletion of the peering before the peering can be deleted.", +"In this mode, changes to the peering configuration can be unilaterally altered by changing either side of the peering. This is the default value if the field is unspecified.", +"Peerings with update strategy UNSPECIFIED are created with update strategy INDEPENDENT." +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkPeeringConnectionStatus": { +"description": "[Output Only] Describes the state of a peering connection, not just the local peering. This field provides information about the effective settings for the connection as a whole, including pending delete/update requests for CONSENSUS peerings.", +"id": "NetworkPeeringConnectionStatus", +"properties": { +"consensusState": { +"$ref": "NetworkPeeringConnectionStatusConsensusState", +"description": "The consensus state contains information about the status of update and delete for a consensus peering connection." +}, +"trafficConfiguration": { +"$ref": "NetworkPeeringConnectionStatusTrafficConfiguration", +"description": "The active connectivity settings for the peering connection based on the settings of the network peerings." +}, +"updateStrategy": { +"description": "The update strategy determines the update/delete semantics for this peering connection.", +"enum": [ +"CONSENSUS", +"INDEPENDENT", +"UNSPECIFIED" +], +"enumDescriptions": [ +"Updates are reflected in the local peering but aren't applied to the peering connection until a complementary change is made to the matching peering. To delete a peering with the consensus update strategy, both the peerings must request the deletion of the peering before the peering can be deleted.", +"In this mode, changes to the peering configuration can be unilaterally altered by changing either side of the peering. This is the default value if the field is unspecified.", +"Peerings with update strategy UNSPECIFIED are created with update strategy INDEPENDENT." +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkPeeringConnectionStatusConsensusState": { +"description": "The status of update/delete for a consensus peering connection. Only set when connection_status.update_strategy is CONSENSUS or a network peering is proposing to update the strategy to CONSENSUS.", +"id": "NetworkPeeringConnectionStatusConsensusState", +"properties": { +"deleteStatus": { +"description": "The status of the delete request.", +"enum": [ +"DELETE_ACKNOWLEDGED", +"DELETE_STATUS_UNSPECIFIED", +"LOCAL_DELETE_REQUESTED", +"PEER_DELETE_REQUESTED" +], +"enumDescriptions": [ +"Both network admins have agreed this consensus peering connection can be deleted.", +"", +"Network admin has requested deletion of this peering connection.", +"The peer network admin has requested deletion of this peering connection." +], +"type": "string" +}, +"updateStatus": { +"description": "The status of the update request.", +"enum": [ +"IN_SYNC", +"PENDING_LOCAL_ACKNOWLEDMENT", +"PENDING_PEER_ACKNOWLEDGEMENT", +"UPDATE_STATUS_UNSPECIFIED" +], +"enumDescriptions": [ +"No pending configuration update proposals to the peering connection.", +"The peer network admin has made an updatePeering call. The change is awaiting acknowledgment from this peering's network admin.", +"The local network admin has made an updatePeering call. The change is awaiting acknowledgment from the peer network admin.", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"NetworkPeeringConnectionStatusTrafficConfiguration": { +"id": "NetworkPeeringConnectionStatusTrafficConfiguration", +"properties": { +"exportCustomRoutesToPeer": { +"description": "Whether custom routes are being exported to the peer network.", +"type": "boolean" +}, +"exportSubnetRoutesWithPublicIpToPeer": { +"description": "Whether subnet routes with public IP ranges are being exported to the peer network.", +"type": "boolean" +}, +"importCustomRoutesFromPeer": { +"description": "Whether custom routes are being imported from the peer network.", +"type": "boolean" +}, +"importSubnetRoutesWithPublicIpFromPeer": { +"description": "Whether subnet routes with public IP ranges are being imported from the peer network.", +"type": "boolean" +}, +"stackType": { +"description": "Which IP version(s) of traffic and routes are being imported or exported between peer networks.", +"enum": [ +"IPV4_IPV6", +"IPV4_ONLY" +], +"enumDescriptions": [ +"This Peering will allow IPv4 traffic and routes to be exchanged. Additionally if the matching peering is IPV4_IPV6, IPv6 traffic and routes will be exchanged as well.", +"This Peering will only allow IPv4 traffic and routes to be exchanged, even if the matching peering is IPV4_IPV6." +], +"type": "string" } }, "type": "object" @@ -66089,6 +66370,16 @@ false }, "type": "object" }, +"NetworksRequestRemovePeeringRequest": { +"id": "NetworksRequestRemovePeeringRequest", +"properties": { +"name": { +"description": "Name of the peering, which should conform to RFC1035.", +"type": "string" +} +}, +"type": "object" +}, "NetworksUpdatePeeringRequest": { "id": "NetworksUpdatePeeringRequest", "properties": { @@ -73497,6 +73788,10 @@ false "description": "Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.", "id": "Reservation", "properties": { +"advancedDeploymentControl": { +"$ref": "ReservationAdvancedDeploymentControl", +"description": "Advanced control for cluster management, applicable only to DENSE deployment type reservations." +}, "aggregateReservation": { "$ref": "AllocationAggregateReservation", "description": "Reservation for aggregated resources, providing shape flexibility." @@ -73638,6 +73933,27 @@ false }, "type": "object" }, +"ReservationAdvancedDeploymentControl": { +"description": "Advance control for cluster management, applicable only to DENSE deployment type reservations.", +"id": "ReservationAdvancedDeploymentControl", +"properties": { +"reservationOperationalMode": { +"description": "Indicates chosen reservation operational mode for the reservation.", +"enum": [ +"ALL_CAPACITY", +"HIGHLY_AVAILABLE_CAPACITY", +"RESERVATION_OPERATIONAL_MODE_UNSPECIFIED" +], +"enumDescriptions": [ +"Google Cloud does not manage the failure of machines, but provides additional capacity, which is not guaranteed to be available.", +"Google Cloud manages the failure of machines to provide high availability.", +"" +], +"type": "string" +} +}, +"type": "object" +}, "ReservationAffinity": { "description": "Specifies the reservations that this instance can consume from.", "id": "ReservationAffinity", @@ -75074,7 +75390,8 @@ false "type": "string" }, "workloadPolicy": { -"$ref": "ResourcePolicyWorkloadPolicy" +"$ref": "ResourcePolicyWorkloadPolicy", +"description": "Resource policy for defining instance placement for MIGs." } }, "type": "object" @@ -75691,9 +76008,11 @@ false "id": "ResourcePolicyWorkloadPolicy", "properties": { "acceleratorTopology": { +"description": "Specifies the topology required to create a partition for VMs that have interconnected GPUs.", "type": "string" }, "maxTopologyDistance": { +"description": "Specifies the maximum distance between instances.", "enum": [ "BLOCK", "CLUSTER", @@ -75707,13 +76026,14 @@ false "type": "string" }, "type": { +"description": "Specifies the intent of the instance placement in the MIG.", "enum": [ "HIGH_AVAILABILITY", "HIGH_THROUGHPUT" ], "enumDescriptions": [ -"VMs will be provisioned in such a way which provides high availability.", -"VMs will be provisioned in such a way which provides high throughput." +"MIG spreads out the instances as much as possible for high availability.", +"MIG provisions instances as close to each other as possible for high throughput." ], "type": "string" } From 5d07a1d9f997e04b3c35d8e8257200279a97e2c3 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:59 +0000 Subject: [PATCH 15/32] feat(contactcenterinsights): update the api #### contactcenterinsights:v1 The following keys were added: - schemas.GoogleCloudContactcenterinsightsV1ConversationQualityMetadata.properties.feedbackLabels (Total Keys: 2) - schemas.GoogleCloudContactcenterinsightsV1alpha1ConversationQualityMetadata.properties.feedbackLabels (Total Keys: 2) --- ...iewSets.authorizedViews.conversations.html | 38 +++++ ...s_v1.projects.locations.conversations.html | 133 ++++++++++++++++++ ...ects.locations.datasets.conversations.html | 38 +++++ .../documents/contactcenterinsights.v1.json | 16 ++- 4 files changed, 224 insertions(+), 1 deletion(-) diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.html index dc94f3bc57e..a741e44d775 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.conversations.html @@ -539,6 +539,25 @@

Method Details

}, ], "customerSatisfactionRating": 42, # An arbitrary integer value indicating the customer's satisfaction rating. + "feedbackLabels": [ # Input only. The feedback labels associated with the conversation. + { # Represents a conversation, resource, and label provided by the user. Can take the form of a string label or a QaAnswer label. QaAnswer labels are used for Quality AI example conversations. String labels are used for Topic Modeling. AgentAssistSummary labels are used for Agent Assist Summarization. + "createTime": "A String", # Output only. Create time of the label. + "label": "A String", # String label used for Topic Modeling. + "labeledResource": "A String", # Name of the resource to be labeled. Supported resources are: * `projects/{project}/locations/{location}/qaScorecards/{scorecard}/revisions/{revision}/qaQuestions/{question}` * `projects/{project}/locations/{location}/issueModels/{issue_model}` * `projects/{project}/locations/{location}/generators/{generator_id}` + "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label} + "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label used for Quality AI example conversations. + "boolValue": True or False, # Boolean value. + "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key. + "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`. + "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score. + "numValue": 3.14, # Numerical value. + "potentialScore": 3.14, # Output only. The maximum potential score of the question. + "score": 3.14, # Output only. Numerical score of the answer. + "strValue": "A String", # String value. + }, + "updateTime": "A String", # Output only. Update time of the label. + }, + ], "menuPath": "A String", # An arbitrary string value specifying the menu path the customer took. "waitDuration": "A String", # The amount of time the customer waited to connect with an agent. }, @@ -949,6 +968,25 @@

Method Details

}, ], "customerSatisfactionRating": 42, # An arbitrary integer value indicating the customer's satisfaction rating. + "feedbackLabels": [ # Input only. The feedback labels associated with the conversation. + { # Represents a conversation, resource, and label provided by the user. Can take the form of a string label or a QaAnswer label. QaAnswer labels are used for Quality AI example conversations. String labels are used for Topic Modeling. AgentAssistSummary labels are used for Agent Assist Summarization. + "createTime": "A String", # Output only. Create time of the label. + "label": "A String", # String label used for Topic Modeling. + "labeledResource": "A String", # Name of the resource to be labeled. Supported resources are: * `projects/{project}/locations/{location}/qaScorecards/{scorecard}/revisions/{revision}/qaQuestions/{question}` * `projects/{project}/locations/{location}/issueModels/{issue_model}` * `projects/{project}/locations/{location}/generators/{generator_id}` + "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label} + "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label used for Quality AI example conversations. + "boolValue": True or False, # Boolean value. + "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key. + "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`. + "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score. + "numValue": 3.14, # Numerical value. + "potentialScore": 3.14, # Output only. The maximum potential score of the question. + "score": 3.14, # Output only. Numerical score of the answer. + "strValue": "A String", # String value. + }, + "updateTime": "A String", # Output only. Update time of the label. + }, + ], "menuPath": "A String", # An arbitrary string value specifying the menu path the customer took. "waitDuration": "A String", # The amount of time the customer waited to connect with an agent. }, diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html index 5fbb902f8a6..af15fc52fd3 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html @@ -570,6 +570,25 @@

Method Details

}, ], "customerSatisfactionRating": 42, # An arbitrary integer value indicating the customer's satisfaction rating. + "feedbackLabels": [ # Input only. The feedback labels associated with the conversation. + { # Represents a conversation, resource, and label provided by the user. Can take the form of a string label or a QaAnswer label. QaAnswer labels are used for Quality AI example conversations. String labels are used for Topic Modeling. AgentAssistSummary labels are used for Agent Assist Summarization. + "createTime": "A String", # Output only. Create time of the label. + "label": "A String", # String label used for Topic Modeling. + "labeledResource": "A String", # Name of the resource to be labeled. Supported resources are: * `projects/{project}/locations/{location}/qaScorecards/{scorecard}/revisions/{revision}/qaQuestions/{question}` * `projects/{project}/locations/{location}/issueModels/{issue_model}` * `projects/{project}/locations/{location}/generators/{generator_id}` + "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label} + "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label used for Quality AI example conversations. + "boolValue": True or False, # Boolean value. + "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key. + "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`. + "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score. + "numValue": 3.14, # Numerical value. + "potentialScore": 3.14, # Output only. The maximum potential score of the question. + "score": 3.14, # Output only. Numerical score of the answer. + "strValue": "A String", # String value. + }, + "updateTime": "A String", # Output only. Update time of the label. + }, + ], "menuPath": "A String", # An arbitrary string value specifying the menu path the customer took. "waitDuration": "A String", # The amount of time the customer waited to connect with an agent. }, @@ -963,6 +982,25 @@

Method Details

}, ], "customerSatisfactionRating": 42, # An arbitrary integer value indicating the customer's satisfaction rating. + "feedbackLabels": [ # Input only. The feedback labels associated with the conversation. + { # Represents a conversation, resource, and label provided by the user. Can take the form of a string label or a QaAnswer label. QaAnswer labels are used for Quality AI example conversations. String labels are used for Topic Modeling. AgentAssistSummary labels are used for Agent Assist Summarization. + "createTime": "A String", # Output only. Create time of the label. + "label": "A String", # String label used for Topic Modeling. + "labeledResource": "A String", # Name of the resource to be labeled. Supported resources are: * `projects/{project}/locations/{location}/qaScorecards/{scorecard}/revisions/{revision}/qaQuestions/{question}` * `projects/{project}/locations/{location}/issueModels/{issue_model}` * `projects/{project}/locations/{location}/generators/{generator_id}` + "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label} + "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label used for Quality AI example conversations. + "boolValue": True or False, # Boolean value. + "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key. + "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`. + "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score. + "numValue": 3.14, # Numerical value. + "potentialScore": 3.14, # Output only. The maximum potential score of the question. + "score": 3.14, # Output only. Numerical score of the answer. + "strValue": "A String", # String value. + }, + "updateTime": "A String", # Output only. Update time of the label. + }, + ], "menuPath": "A String", # An arbitrary string value specifying the menu path the customer took. "waitDuration": "A String", # The amount of time the customer waited to connect with an agent. }, @@ -1386,6 +1424,25 @@

Method Details

}, ], "customerSatisfactionRating": 42, # An arbitrary integer value indicating the customer's satisfaction rating. + "feedbackLabels": [ # Input only. The feedback labels associated with the conversation. + { # Represents a conversation, resource, and label provided by the user. Can take the form of a string label or a QaAnswer label. QaAnswer labels are used for Quality AI example conversations. String labels are used for Topic Modeling. AgentAssistSummary labels are used for Agent Assist Summarization. + "createTime": "A String", # Output only. Create time of the label. + "label": "A String", # String label used for Topic Modeling. + "labeledResource": "A String", # Name of the resource to be labeled. Supported resources are: * `projects/{project}/locations/{location}/qaScorecards/{scorecard}/revisions/{revision}/qaQuestions/{question}` * `projects/{project}/locations/{location}/issueModels/{issue_model}` * `projects/{project}/locations/{location}/generators/{generator_id}` + "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label} + "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label used for Quality AI example conversations. + "boolValue": True or False, # Boolean value. + "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key. + "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`. + "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score. + "numValue": 3.14, # Numerical value. + "potentialScore": 3.14, # Output only. The maximum potential score of the question. + "score": 3.14, # Output only. Numerical score of the answer. + "strValue": "A String", # String value. + }, + "updateTime": "A String", # Output only. Update time of the label. + }, + ], "menuPath": "A String", # An arbitrary string value specifying the menu path the customer took. "waitDuration": "A String", # The amount of time the customer waited to connect with an agent. }, @@ -1864,6 +1921,25 @@

Method Details

}, ], "customerSatisfactionRating": 42, # An arbitrary integer value indicating the customer's satisfaction rating. + "feedbackLabels": [ # Input only. The feedback labels associated with the conversation. + { # Represents a conversation, resource, and label provided by the user. Can take the form of a string label or a QaAnswer label. QaAnswer labels are used for Quality AI example conversations. String labels are used for Topic Modeling. AgentAssistSummary labels are used for Agent Assist Summarization. + "createTime": "A String", # Output only. Create time of the label. + "label": "A String", # String label used for Topic Modeling. + "labeledResource": "A String", # Name of the resource to be labeled. Supported resources are: * `projects/{project}/locations/{location}/qaScorecards/{scorecard}/revisions/{revision}/qaQuestions/{question}` * `projects/{project}/locations/{location}/issueModels/{issue_model}` * `projects/{project}/locations/{location}/generators/{generator_id}` + "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label} + "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label used for Quality AI example conversations. + "boolValue": True or False, # Boolean value. + "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key. + "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`. + "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score. + "numValue": 3.14, # Numerical value. + "potentialScore": 3.14, # Output only. The maximum potential score of the question. + "score": 3.14, # Output only. Numerical score of the answer. + "strValue": "A String", # String value. + }, + "updateTime": "A String", # Output only. Update time of the label. + }, + ], "menuPath": "A String", # An arbitrary string value specifying the menu path the customer took. "waitDuration": "A String", # The amount of time the customer waited to connect with an agent. }, @@ -2275,6 +2351,25 @@

Method Details

}, ], "customerSatisfactionRating": 42, # An arbitrary integer value indicating the customer's satisfaction rating. + "feedbackLabels": [ # Input only. The feedback labels associated with the conversation. + { # Represents a conversation, resource, and label provided by the user. Can take the form of a string label or a QaAnswer label. QaAnswer labels are used for Quality AI example conversations. String labels are used for Topic Modeling. AgentAssistSummary labels are used for Agent Assist Summarization. + "createTime": "A String", # Output only. Create time of the label. + "label": "A String", # String label used for Topic Modeling. + "labeledResource": "A String", # Name of the resource to be labeled. Supported resources are: * `projects/{project}/locations/{location}/qaScorecards/{scorecard}/revisions/{revision}/qaQuestions/{question}` * `projects/{project}/locations/{location}/issueModels/{issue_model}` * `projects/{project}/locations/{location}/generators/{generator_id}` + "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label} + "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label used for Quality AI example conversations. + "boolValue": True or False, # Boolean value. + "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key. + "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`. + "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score. + "numValue": 3.14, # Numerical value. + "potentialScore": 3.14, # Output only. The maximum potential score of the question. + "score": 3.14, # Output only. Numerical score of the answer. + "strValue": "A String", # String value. + }, + "updateTime": "A String", # Output only. Update time of the label. + }, + ], "menuPath": "A String", # An arbitrary string value specifying the menu path the customer took. "waitDuration": "A String", # The amount of time the customer waited to connect with an agent. }, @@ -2669,6 +2764,25 @@

Method Details

}, ], "customerSatisfactionRating": 42, # An arbitrary integer value indicating the customer's satisfaction rating. + "feedbackLabels": [ # Input only. The feedback labels associated with the conversation. + { # Represents a conversation, resource, and label provided by the user. Can take the form of a string label or a QaAnswer label. QaAnswer labels are used for Quality AI example conversations. String labels are used for Topic Modeling. AgentAssistSummary labels are used for Agent Assist Summarization. + "createTime": "A String", # Output only. Create time of the label. + "label": "A String", # String label used for Topic Modeling. + "labeledResource": "A String", # Name of the resource to be labeled. Supported resources are: * `projects/{project}/locations/{location}/qaScorecards/{scorecard}/revisions/{revision}/qaQuestions/{question}` * `projects/{project}/locations/{location}/issueModels/{issue_model}` * `projects/{project}/locations/{location}/generators/{generator_id}` + "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label} + "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label used for Quality AI example conversations. + "boolValue": True or False, # Boolean value. + "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key. + "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`. + "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score. + "numValue": 3.14, # Numerical value. + "potentialScore": 3.14, # Output only. The maximum potential score of the question. + "score": 3.14, # Output only. Numerical score of the answer. + "strValue": "A String", # String value. + }, + "updateTime": "A String", # Output only. Update time of the label. + }, + ], "menuPath": "A String", # An arbitrary string value specifying the menu path the customer took. "waitDuration": "A String", # The amount of time the customer waited to connect with an agent. }, @@ -3064,6 +3178,25 @@

Method Details

}, ], "customerSatisfactionRating": 42, # An arbitrary integer value indicating the customer's satisfaction rating. + "feedbackLabels": [ # Input only. The feedback labels associated with the conversation. + { # Represents a conversation, resource, and label provided by the user. Can take the form of a string label or a QaAnswer label. QaAnswer labels are used for Quality AI example conversations. String labels are used for Topic Modeling. AgentAssistSummary labels are used for Agent Assist Summarization. + "createTime": "A String", # Output only. Create time of the label. + "label": "A String", # String label used for Topic Modeling. + "labeledResource": "A String", # Name of the resource to be labeled. Supported resources are: * `projects/{project}/locations/{location}/qaScorecards/{scorecard}/revisions/{revision}/qaQuestions/{question}` * `projects/{project}/locations/{location}/issueModels/{issue_model}` * `projects/{project}/locations/{location}/generators/{generator_id}` + "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label} + "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label used for Quality AI example conversations. + "boolValue": True or False, # Boolean value. + "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key. + "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`. + "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score. + "numValue": 3.14, # Numerical value. + "potentialScore": 3.14, # Output only. The maximum potential score of the question. + "score": 3.14, # Output only. Numerical score of the answer. + "strValue": "A String", # String value. + }, + "updateTime": "A String", # Output only. Update time of the label. + }, + ], "menuPath": "A String", # An arbitrary string value specifying the menu path the customer took. "waitDuration": "A String", # The amount of time the customer waited to connect with an agent. }, diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html index cc25f53e209..89d6659d29e 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html @@ -591,6 +591,25 @@

Method Details

}, ], "customerSatisfactionRating": 42, # An arbitrary integer value indicating the customer's satisfaction rating. + "feedbackLabels": [ # Input only. The feedback labels associated with the conversation. + { # Represents a conversation, resource, and label provided by the user. Can take the form of a string label or a QaAnswer label. QaAnswer labels are used for Quality AI example conversations. String labels are used for Topic Modeling. AgentAssistSummary labels are used for Agent Assist Summarization. + "createTime": "A String", # Output only. Create time of the label. + "label": "A String", # String label used for Topic Modeling. + "labeledResource": "A String", # Name of the resource to be labeled. Supported resources are: * `projects/{project}/locations/{location}/qaScorecards/{scorecard}/revisions/{revision}/qaQuestions/{question}` * `projects/{project}/locations/{location}/issueModels/{issue_model}` * `projects/{project}/locations/{location}/generators/{generator_id}` + "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label} + "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label used for Quality AI example conversations. + "boolValue": True or False, # Boolean value. + "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key. + "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`. + "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score. + "numValue": 3.14, # Numerical value. + "potentialScore": 3.14, # Output only. The maximum potential score of the question. + "score": 3.14, # Output only. Numerical score of the answer. + "strValue": "A String", # String value. + }, + "updateTime": "A String", # Output only. Update time of the label. + }, + ], "menuPath": "A String", # An arbitrary string value specifying the menu path the customer took. "waitDuration": "A String", # The amount of time the customer waited to connect with an agent. }, @@ -1069,6 +1088,25 @@

Method Details

}, ], "customerSatisfactionRating": 42, # An arbitrary integer value indicating the customer's satisfaction rating. + "feedbackLabels": [ # Input only. The feedback labels associated with the conversation. + { # Represents a conversation, resource, and label provided by the user. Can take the form of a string label or a QaAnswer label. QaAnswer labels are used for Quality AI example conversations. String labels are used for Topic Modeling. AgentAssistSummary labels are used for Agent Assist Summarization. + "createTime": "A String", # Output only. Create time of the label. + "label": "A String", # String label used for Topic Modeling. + "labeledResource": "A String", # Name of the resource to be labeled. Supported resources are: * `projects/{project}/locations/{location}/qaScorecards/{scorecard}/revisions/{revision}/qaQuestions/{question}` * `projects/{project}/locations/{location}/issueModels/{issue_model}` * `projects/{project}/locations/{location}/generators/{generator_id}` + "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label} + "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label used for Quality AI example conversations. + "boolValue": True or False, # Boolean value. + "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key. + "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`. + "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score. + "numValue": 3.14, # Numerical value. + "potentialScore": 3.14, # Output only. The maximum potential score of the question. + "score": 3.14, # Output only. Numerical score of the answer. + "strValue": "A String", # String value. + }, + "updateTime": "A String", # Output only. Update time of the label. + }, + ], "menuPath": "A String", # An arbitrary string value specifying the menu path the customer took. "waitDuration": "A String", # The amount of time the customer waited to connect with an agent. }, diff --git a/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json b/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json index f8b68355694..2ffd6e42182 100644 --- a/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json +++ b/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json @@ -5305,7 +5305,7 @@ } } }, -"revision": "20250729", +"revision": "20250804", "rootUrl": "https://contactcenterinsights.googleapis.com/", "schemas": { "GoogleCloudContactcenterinsightsV1Analysis": { @@ -6656,6 +6656,13 @@ true "format": "int32", "type": "integer" }, +"feedbackLabels": { +"description": "Input only. The feedback labels associated with the conversation.", +"items": { +"$ref": "GoogleCloudContactcenterinsightsV1FeedbackLabel" +}, +"type": "array" +}, "menuPath": { "description": "An arbitrary string value specifying the menu path the customer took.", "type": "string" @@ -11080,6 +11087,13 @@ true "format": "int32", "type": "integer" }, +"feedbackLabels": { +"description": "Input only. The feedback labels associated with the conversation.", +"items": { +"$ref": "GoogleCloudContactcenterinsightsV1alpha1FeedbackLabel" +}, +"type": "array" +}, "menuPath": { "description": "An arbitrary string value specifying the menu path the customer took.", "type": "string" From 07e8e9f9c798ab129aa94e416cccc220c1243ad5 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:59 +0000 Subject: [PATCH 16/32] feat(dialogflow): update the api #### dialogflow:v3 The following keys were added: - schemas.GoogleCloudDialogflowCxV3Action.properties.flowTransition.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowCxV3Action.properties.playbookTransition.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowCxV3Flow.properties.inputParameterDefinitions (Total Keys: 2) - schemas.GoogleCloudDialogflowCxV3Flow.properties.outputParameterDefinitions (Total Keys: 2) - schemas.GoogleCloudDialogflowCxV3FlowTransition (Total Keys: 5) - schemas.GoogleCloudDialogflowCxV3InlineSchema (Total Keys: 4) - schemas.GoogleCloudDialogflowCxV3ParameterDefinition (Total Keys: 6) - schemas.GoogleCloudDialogflowCxV3Playbook.properties.inputParameterDefinitions (Total Keys: 2) - schemas.GoogleCloudDialogflowCxV3Playbook.properties.outputParameterDefinitions (Total Keys: 2) - schemas.GoogleCloudDialogflowCxV3Playbook.properties.playbookType.type (Total Keys: 1) - schemas.GoogleCloudDialogflowCxV3PlaybookTransition (Total Keys: 5) - schemas.GoogleCloudDialogflowCxV3TypeSchema (Total Keys: 8) #### dialogflow:v3beta1 The following keys were added: - schemas.GoogleCloudDialogflowCxV3beta1Flow.properties.inputParameterDefinitions (Total Keys: 2) - schemas.GoogleCloudDialogflowCxV3beta1Flow.properties.outputParameterDefinitions (Total Keys: 2) --- ...ow_v3.projects.locations.agents.flows.html | 204 +++++++++++++++++ ...s.locations.agents.playbooks.examples.html | 48 ++++ ...3.projects.locations.agents.playbooks.html | 210 ++++++++++++++++++ ...s.locations.agents.playbooks.versions.html | 207 +++++++++++++++++ ...3.projects.locations.agents.testCases.html | 68 ++++++ ...ojects.locations.agents.conversations.html | 204 +++++++++++++++++ ...ocations.agents.environments.sessions.html | 102 +++++++++ ...beta1.projects.locations.agents.flows.html | 204 +++++++++++++++++ ...a1.projects.locations.agents.sessions.html | 102 +++++++++ ...1.projects.locations.agents.testCases.html | 68 ++++++ .../documents/dialogflow.v3.json | 185 ++++++++++++++- .../documents/dialogflow.v3beta1.json | 16 +- 12 files changed, 1616 insertions(+), 2 deletions(-) diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.flows.html b/docs/dyn/dialogflow_v3.projects.locations.agents.flows.html index bfa26024b1f..de3893be18f 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.flows.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.flows.html @@ -349,6 +349,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -546,6 +563,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format: `projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -951,6 +985,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -1148,6 +1199,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format: `projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -1622,6 +1690,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -1819,6 +1904,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format: `projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -2319,6 +2421,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -2516,6 +2635,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format: `projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -2939,6 +3075,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -3136,6 +3289,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format: `projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -3542,6 +3712,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -3739,6 +3926,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format: `projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.examples.html b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.examples.html index 47e1bfbf13b..39ff970a176 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.examples.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.examples.html @@ -121,6 +121,10 @@

Method Details

"flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents//flows/`. "flowState": "A String", # Required. Flow invocation's output state. }, + "flowTransition": { # Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow. # Optional. Action performed on behalf of the agent by transitioning to a target CX flow. + "displayName": "A String", # Output only. The display name of the flow. + "flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents/`. + }, "playbookInvocation": { # Stores metadata of the invocation of a child playbook. # Optional. Action performed on behalf of the agent by invoking a child playbook. "displayName": "A String", # Output only. The display name of the playbook. "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. @@ -132,6 +136,10 @@

Method Details

}, "playbookState": "A String", # Required. Playbook invocation's output state. }, + "playbookTransition": { # Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook. # Optional. Action performed on behalf of the agent by transitioning to a target playbook. + "displayName": "A String", # Output only. The display name of the playbook. + "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + }, "toolUse": { # Stores metadata of the invocation of an action supported by a tool. # Optional. Action performed on behalf of the agent by calling a plugin tool. "action": "A String", # Optional. Name of the action to be called during the tool use. "displayName": "A String", # Output only. The display name of the tool. @@ -183,6 +191,10 @@

Method Details

"flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents//flows/`. "flowState": "A String", # Required. Flow invocation's output state. }, + "flowTransition": { # Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow. # Optional. Action performed on behalf of the agent by transitioning to a target CX flow. + "displayName": "A String", # Output only. The display name of the flow. + "flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents/`. + }, "playbookInvocation": { # Stores metadata of the invocation of a child playbook. # Optional. Action performed on behalf of the agent by invoking a child playbook. "displayName": "A String", # Output only. The display name of the playbook. "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. @@ -194,6 +206,10 @@

Method Details

}, "playbookState": "A String", # Required. Playbook invocation's output state. }, + "playbookTransition": { # Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook. # Optional. Action performed on behalf of the agent by transitioning to a target playbook. + "displayName": "A String", # Output only. The display name of the playbook. + "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + }, "toolUse": { # Stores metadata of the invocation of an action supported by a tool. # Optional. Action performed on behalf of the agent by calling a plugin tool. "action": "A String", # Optional. Name of the action to be called during the tool use. "displayName": "A String", # Output only. The display name of the tool. @@ -270,6 +286,10 @@

Method Details

"flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents//flows/`. "flowState": "A String", # Required. Flow invocation's output state. }, + "flowTransition": { # Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow. # Optional. Action performed on behalf of the agent by transitioning to a target CX flow. + "displayName": "A String", # Output only. The display name of the flow. + "flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents/`. + }, "playbookInvocation": { # Stores metadata of the invocation of a child playbook. # Optional. Action performed on behalf of the agent by invoking a child playbook. "displayName": "A String", # Output only. The display name of the playbook. "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. @@ -281,6 +301,10 @@

Method Details

}, "playbookState": "A String", # Required. Playbook invocation's output state. }, + "playbookTransition": { # Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook. # Optional. Action performed on behalf of the agent by transitioning to a target playbook. + "displayName": "A String", # Output only. The display name of the playbook. + "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + }, "toolUse": { # Stores metadata of the invocation of an action supported by a tool. # Optional. Action performed on behalf of the agent by calling a plugin tool. "action": "A String", # Optional. Name of the action to be called during the tool use. "displayName": "A String", # Output only. The display name of the tool. @@ -344,6 +368,10 @@

Method Details

"flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents//flows/`. "flowState": "A String", # Required. Flow invocation's output state. }, + "flowTransition": { # Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow. # Optional. Action performed on behalf of the agent by transitioning to a target CX flow. + "displayName": "A String", # Output only. The display name of the flow. + "flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents/`. + }, "playbookInvocation": { # Stores metadata of the invocation of a child playbook. # Optional. Action performed on behalf of the agent by invoking a child playbook. "displayName": "A String", # Output only. The display name of the playbook. "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. @@ -355,6 +383,10 @@

Method Details

}, "playbookState": "A String", # Required. Playbook invocation's output state. }, + "playbookTransition": { # Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook. # Optional. Action performed on behalf of the agent by transitioning to a target playbook. + "displayName": "A String", # Output only. The display name of the playbook. + "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + }, "toolUse": { # Stores metadata of the invocation of an action supported by a tool. # Optional. Action performed on behalf of the agent by calling a plugin tool. "action": "A String", # Optional. Name of the action to be called during the tool use. "displayName": "A String", # Output only. The display name of the tool. @@ -425,6 +457,10 @@

Method Details

"flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents//flows/`. "flowState": "A String", # Required. Flow invocation's output state. }, + "flowTransition": { # Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow. # Optional. Action performed on behalf of the agent by transitioning to a target CX flow. + "displayName": "A String", # Output only. The display name of the flow. + "flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents/`. + }, "playbookInvocation": { # Stores metadata of the invocation of a child playbook. # Optional. Action performed on behalf of the agent by invoking a child playbook. "displayName": "A String", # Output only. The display name of the playbook. "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. @@ -436,6 +472,10 @@

Method Details

}, "playbookState": "A String", # Required. Playbook invocation's output state. }, + "playbookTransition": { # Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook. # Optional. Action performed on behalf of the agent by transitioning to a target playbook. + "displayName": "A String", # Output only. The display name of the playbook. + "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + }, "toolUse": { # Stores metadata of the invocation of an action supported by a tool. # Optional. Action performed on behalf of the agent by calling a plugin tool. "action": "A String", # Optional. Name of the action to be called during the tool use. "displayName": "A String", # Output only. The display name of the tool. @@ -488,6 +528,10 @@

Method Details

"flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents//flows/`. "flowState": "A String", # Required. Flow invocation's output state. }, + "flowTransition": { # Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow. # Optional. Action performed on behalf of the agent by transitioning to a target CX flow. + "displayName": "A String", # Output only. The display name of the flow. + "flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents/`. + }, "playbookInvocation": { # Stores metadata of the invocation of a child playbook. # Optional. Action performed on behalf of the agent by invoking a child playbook. "displayName": "A String", # Output only. The display name of the playbook. "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. @@ -499,6 +543,10 @@

Method Details

}, "playbookState": "A String", # Required. Playbook invocation's output state. }, + "playbookTransition": { # Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook. # Optional. Action performed on behalf of the agent by transitioning to a target playbook. + "displayName": "A String", # Output only. The display name of the playbook. + "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + }, "toolUse": { # Stores metadata of the invocation of an action supported by a tool. # Optional. Action performed on behalf of the agent by calling a plugin tool. "action": "A String", # Optional. Name of the action to be called during the tool use. "displayName": "A String", # Output only. The display name of the tool. diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.html b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.html index 58bcfd92758..f733ad1e799 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.html @@ -486,6 +486,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "instruction": { # Message of the Instruction of the playbook. # Instruction to accomplish target goal. "guidelines": "A String", # General guidelines for the playbook. These are unstructured instructions that are not directly part of the goal, e.g. "Always be polite". It's valid for this text to be long and used instead of steps altogether. "steps": [ # Ordered list of step by step execution instructions to accomplish target goal. @@ -502,6 +519,24 @@

Method Details

"promptText": "A String", # The custom prompt to use. }, "name": "A String", # The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], + "playbookType": "A String", # Optional. Type of the playbook. "referencedFlows": [ # Output only. The resource name of flows referenced by the current playbook in the instructions. "A String", ], @@ -883,6 +918,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "instruction": { # Message of the Instruction of the playbook. # Instruction to accomplish target goal. "guidelines": "A String", # General guidelines for the playbook. These are unstructured instructions that are not directly part of the goal, e.g. "Always be polite". It's valid for this text to be long and used instead of steps altogether. "steps": [ # Ordered list of step by step execution instructions to accomplish target goal. @@ -899,6 +951,24 @@

Method Details

"promptText": "A String", # The custom prompt to use. }, "name": "A String", # The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], + "playbookType": "A String", # Optional. Type of the playbook. "referencedFlows": [ # Output only. The resource name of flows referenced by the current playbook in the instructions. "A String", ], @@ -1348,6 +1418,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "instruction": { # Message of the Instruction of the playbook. # Instruction to accomplish target goal. "guidelines": "A String", # General guidelines for the playbook. These are unstructured instructions that are not directly part of the goal, e.g. "Always be polite". It's valid for this text to be long and used instead of steps altogether. "steps": [ # Ordered list of step by step execution instructions to accomplish target goal. @@ -1364,6 +1451,24 @@

Method Details

"promptText": "A String", # The custom prompt to use. }, "name": "A String", # The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], + "playbookType": "A String", # Optional. Type of the playbook. "referencedFlows": [ # Output only. The resource name of flows referenced by the current playbook in the instructions. "A String", ], @@ -1805,6 +1910,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "instruction": { # Message of the Instruction of the playbook. # Instruction to accomplish target goal. "guidelines": "A String", # General guidelines for the playbook. These are unstructured instructions that are not directly part of the goal, e.g. "Always be polite". It's valid for this text to be long and used instead of steps altogether. "steps": [ # Ordered list of step by step execution instructions to accomplish target goal. @@ -1821,6 +1943,24 @@

Method Details

"promptText": "A String", # The custom prompt to use. }, "name": "A String", # The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], + "playbookType": "A String", # Optional. Type of the playbook. "referencedFlows": [ # Output only. The resource name of flows referenced by the current playbook in the instructions. "A String", ], @@ -2220,6 +2360,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "instruction": { # Message of the Instruction of the playbook. # Instruction to accomplish target goal. "guidelines": "A String", # General guidelines for the playbook. These are unstructured instructions that are not directly part of the goal, e.g. "Always be polite". It's valid for this text to be long and used instead of steps altogether. "steps": [ # Ordered list of step by step execution instructions to accomplish target goal. @@ -2236,6 +2393,24 @@

Method Details

"promptText": "A String", # The custom prompt to use. }, "name": "A String", # The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], + "playbookType": "A String", # Optional. Type of the playbook. "referencedFlows": [ # Output only. The resource name of flows referenced by the current playbook in the instructions. "A String", ], @@ -2618,6 +2793,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "instruction": { # Message of the Instruction of the playbook. # Instruction to accomplish target goal. "guidelines": "A String", # General guidelines for the playbook. These are unstructured instructions that are not directly part of the goal, e.g. "Always be polite". It's valid for this text to be long and used instead of steps altogether. "steps": [ # Ordered list of step by step execution instructions to accomplish target goal. @@ -2634,6 +2826,24 @@

Method Details

"promptText": "A String", # The custom prompt to use. }, "name": "A String", # The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], + "playbookType": "A String", # Optional. Type of the playbook. "referencedFlows": [ # Output only. The resource name of flows referenced by the current playbook in the instructions. "A String", ], diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.versions.html b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.versions.html index 679551275a8..1e2d5de9645 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.versions.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.playbooks.versions.html @@ -124,6 +124,10 @@

Method Details

"flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents//flows/`. "flowState": "A String", # Required. Flow invocation's output state. }, + "flowTransition": { # Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow. # Optional. Action performed on behalf of the agent by transitioning to a target CX flow. + "displayName": "A String", # Output only. The display name of the flow. + "flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents/`. + }, "playbookInvocation": { # Stores metadata of the invocation of a child playbook. # Optional. Action performed on behalf of the agent by invoking a child playbook. "displayName": "A String", # Output only. The display name of the playbook. "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. @@ -135,6 +139,10 @@

Method Details

}, "playbookState": "A String", # Required. Playbook invocation's output state. }, + "playbookTransition": { # Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook. # Optional. Action performed on behalf of the agent by transitioning to a target playbook. + "displayName": "A String", # Output only. The display name of the playbook. + "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + }, "toolUse": { # Stores metadata of the invocation of an action supported by a tool. # Optional. Action performed on behalf of the agent by calling a plugin tool. "action": "A String", # Optional. Name of the action to be called during the tool use. "displayName": "A String", # Output only. The display name of the tool. @@ -528,6 +536,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "instruction": { # Message of the Instruction of the playbook. # Instruction to accomplish target goal. "guidelines": "A String", # General guidelines for the playbook. These are unstructured instructions that are not directly part of the goal, e.g. "Always be polite". It's valid for this text to be long and used instead of steps altogether. "steps": [ # Ordered list of step by step execution instructions to accomplish target goal. @@ -544,6 +569,24 @@

Method Details

"promptText": "A String", # The custom prompt to use. }, "name": "A String", # The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], + "playbookType": "A String", # Optional. Type of the playbook. "referencedFlows": [ # Output only. The resource name of flows referenced by the current playbook in the instructions. "A String", ], @@ -581,6 +624,10 @@

Method Details

"flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents//flows/`. "flowState": "A String", # Required. Flow invocation's output state. }, + "flowTransition": { # Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow. # Optional. Action performed on behalf of the agent by transitioning to a target CX flow. + "displayName": "A String", # Output only. The display name of the flow. + "flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents/`. + }, "playbookInvocation": { # Stores metadata of the invocation of a child playbook. # Optional. Action performed on behalf of the agent by invoking a child playbook. "displayName": "A String", # Output only. The display name of the playbook. "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. @@ -592,6 +639,10 @@

Method Details

}, "playbookState": "A String", # Required. Playbook invocation's output state. }, + "playbookTransition": { # Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook. # Optional. Action performed on behalf of the agent by transitioning to a target playbook. + "displayName": "A String", # Output only. The display name of the playbook. + "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + }, "toolUse": { # Stores metadata of the invocation of an action supported by a tool. # Optional. Action performed on behalf of the agent by calling a plugin tool. "action": "A String", # Optional. Name of the action to be called during the tool use. "displayName": "A String", # Output only. The display name of the tool. @@ -985,6 +1036,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "instruction": { # Message of the Instruction of the playbook. # Instruction to accomplish target goal. "guidelines": "A String", # General guidelines for the playbook. These are unstructured instructions that are not directly part of the goal, e.g. "Always be polite". It's valid for this text to be long and used instead of steps altogether. "steps": [ # Ordered list of step by step execution instructions to accomplish target goal. @@ -1001,6 +1069,24 @@

Method Details

"promptText": "A String", # The custom prompt to use. }, "name": "A String", # The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], + "playbookType": "A String", # Optional. Type of the playbook. "referencedFlows": [ # Output only. The resource name of flows referenced by the current playbook in the instructions. "A String", ], @@ -1063,6 +1149,10 @@

Method Details

"flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents//flows/`. "flowState": "A String", # Required. Flow invocation's output state. }, + "flowTransition": { # Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow. # Optional. Action performed on behalf of the agent by transitioning to a target CX flow. + "displayName": "A String", # Output only. The display name of the flow. + "flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents/`. + }, "playbookInvocation": { # Stores metadata of the invocation of a child playbook. # Optional. Action performed on behalf of the agent by invoking a child playbook. "displayName": "A String", # Output only. The display name of the playbook. "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. @@ -1074,6 +1164,10 @@

Method Details

}, "playbookState": "A String", # Required. Playbook invocation's output state. }, + "playbookTransition": { # Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook. # Optional. Action performed on behalf of the agent by transitioning to a target playbook. + "displayName": "A String", # Output only. The display name of the playbook. + "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + }, "toolUse": { # Stores metadata of the invocation of an action supported by a tool. # Optional. Action performed on behalf of the agent by calling a plugin tool. "action": "A String", # Optional. Name of the action to be called during the tool use. "displayName": "A String", # Output only. The display name of the tool. @@ -1467,6 +1561,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "instruction": { # Message of the Instruction of the playbook. # Instruction to accomplish target goal. "guidelines": "A String", # General guidelines for the playbook. These are unstructured instructions that are not directly part of the goal, e.g. "Always be polite". It's valid for this text to be long and used instead of steps altogether. "steps": [ # Ordered list of step by step execution instructions to accomplish target goal. @@ -1483,6 +1594,24 @@

Method Details

"promptText": "A String", # The custom prompt to use. }, "name": "A String", # The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], + "playbookType": "A String", # Optional. Type of the playbook. "referencedFlows": [ # Output only. The resource name of flows referenced by the current playbook in the instructions. "A String", ], @@ -1532,6 +1661,10 @@

Method Details

"flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents//flows/`. "flowState": "A String", # Required. Flow invocation's output state. }, + "flowTransition": { # Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow. # Optional. Action performed on behalf of the agent by transitioning to a target CX flow. + "displayName": "A String", # Output only. The display name of the flow. + "flow": "A String", # Required. The unique identifier of the flow. Format: `projects//locations//agents/`. + }, "playbookInvocation": { # Stores metadata of the invocation of a child playbook. # Optional. Action performed on behalf of the agent by invoking a child playbook. "displayName": "A String", # Output only. The display name of the playbook. "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. @@ -1543,6 +1676,10 @@

Method Details

}, "playbookState": "A String", # Required. Playbook invocation's output state. }, + "playbookTransition": { # Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook. # Optional. Action performed on behalf of the agent by transitioning to a target playbook. + "displayName": "A String", # Output only. The display name of the playbook. + "playbook": "A String", # Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + }, "toolUse": { # Stores metadata of the invocation of an action supported by a tool. # Optional. Action performed on behalf of the agent by calling a plugin tool. "action": "A String", # Optional. Name of the action to be called during the tool use. "displayName": "A String", # Output only. The display name of the tool. @@ -1936,6 +2073,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "instruction": { # Message of the Instruction of the playbook. # Instruction to accomplish target goal. "guidelines": "A String", # General guidelines for the playbook. These are unstructured instructions that are not directly part of the goal, e.g. "Always be polite". It's valid for this text to be long and used instead of steps altogether. "steps": [ # Ordered list of step by step execution instructions to accomplish target goal. @@ -1952,6 +2106,24 @@

Method Details

"promptText": "A String", # The custom prompt to use. }, "name": "A String", # The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], + "playbookType": "A String", # Optional. Type of the playbook. "referencedFlows": [ # Output only. The resource name of flows referenced by the current playbook in the instructions. "A String", ], @@ -2365,6 +2537,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "instruction": { # Message of the Instruction of the playbook. # Instruction to accomplish target goal. "guidelines": "A String", # General guidelines for the playbook. These are unstructured instructions that are not directly part of the goal, e.g. "Always be polite". It's valid for this text to be long and used instead of steps altogether. "steps": [ # Ordered list of step by step execution instructions to accomplish target goal. @@ -2381,6 +2570,24 @@

Method Details

"promptText": "A String", # The custom prompt to use. }, "name": "A String", # The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`. + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this playbook. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], + "playbookType": "A String", # Optional. Type of the playbook. "referencedFlows": [ # Output only. The resource name of flows referenced by the current playbook in the instructions. "A String", ], diff --git a/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.html b/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.html index 9bf95a1e189..31d55344ebd 100644 --- a/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.html +++ b/docs/dyn/dialogflow_v3.projects.locations.agents.testCases.html @@ -993,6 +993,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -1190,6 +1207,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format: `projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -2731,6 +2765,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -2928,6 +2979,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format: `projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.conversations.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.conversations.html index 1a7b26ff070..db7f6ecbca9 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.conversations.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.conversations.html @@ -437,6 +437,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -632,6 +649,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -1120,6 +1154,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -1315,6 +1366,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -3502,6 +3570,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -3697,6 +3782,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -6983,6 +7085,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -7178,6 +7297,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -7666,6 +7802,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -7861,6 +8014,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -10048,6 +10218,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -10243,6 +10430,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.sessions.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.sessions.html index 3fd4c5da75c..3a4bca545f9 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.sessions.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.environments.sessions.html @@ -521,6 +521,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -716,6 +733,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -2961,6 +2995,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -3156,6 +3207,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -6693,6 +6761,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -6888,6 +6973,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.html index ed3808ee417..1d81501d5ad 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.flows.html @@ -347,6 +347,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -542,6 +559,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -943,6 +977,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -1138,6 +1189,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -1608,6 +1676,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -1803,6 +1888,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -2299,6 +2401,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -2494,6 +2613,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -2913,6 +3049,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -3108,6 +3261,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -3510,6 +3680,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -3705,6 +3892,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.sessions.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.sessions.html index 8d1c4169ef8..edb142fc024 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.sessions.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.sessions.html @@ -524,6 +524,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -719,6 +736,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -2964,6 +2998,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -3159,6 +3210,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -6696,6 +6764,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -6891,6 +6976,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], diff --git a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.html b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.html index 212caa0eb65..50034a6d7f5 100644 --- a/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.html +++ b/docs/dyn/dialogflow_v3beta1.projects.locations.agents.testCases.html @@ -985,6 +985,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -1180,6 +1197,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], @@ -2705,6 +2739,23 @@

Method Details

}, }, ], + "inputParameterDefinitions": [ # Optional. Defined structured input parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "knowledgeConnectorSettings": { # The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. # Optional. Knowledge connector configuration. "dataStoreConnections": [ # Optional. List of related data store connections. { # A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains. @@ -2900,6 +2951,23 @@

Method Details

"modelTrainingMode": "A String", # Indicates NLU model training mode. "modelType": "A String", # Indicates the type of NLU model. }, + "outputParameterDefinitions": [ # Optional. Defined structured output parameters for this flow. + { # Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. + "description": "A String", # Human-readable description of the parameter. Limited to 300 characters. + "name": "A String", # Required. Name of parameter. + "type": "A String", # Type of parameter. + "typeSchema": { # Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition. # Optional. Type schema of parameter. + "inlineSchema": { # A type schema object that's specified inline. # Set if this is an inline schema definition. + "items": # Object with schema name: GoogleCloudDialogflowCxV3beta1TypeSchema # Schema of the elements if this is an ARRAY type. + "type": "A String", # Data type of the schema. + }, + "schemaReference": { # A reference to the schema of an existing tool. # Set if this is a schema reference. + "schema": "A String", # The name of the schema. + "tool": "A String", # The tool that contains this schema definition. Format: `projects//locations//agents//tools/`. + }, + }, + }, + ], "transitionRouteGroups": [ # A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups. "A String", ], diff --git a/googleapiclient/discovery_cache/documents/dialogflow.v3.json b/googleapiclient/discovery_cache/documents/dialogflow.v3.json index 4b717dbe68d..2c24b1abced 100644 --- a/googleapiclient/discovery_cache/documents/dialogflow.v3.json +++ b/googleapiclient/discovery_cache/documents/dialogflow.v3.json @@ -5309,7 +5309,7 @@ } } }, -"revision": "20250627", +"revision": "20250804", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3Action": { @@ -5324,10 +5324,18 @@ "$ref": "GoogleCloudDialogflowCxV3FlowInvocation", "description": "Optional. Action performed on behalf of the agent by invoking a CX flow." }, +"flowTransition": { +"$ref": "GoogleCloudDialogflowCxV3FlowTransition", +"description": "Optional. Action performed on behalf of the agent by transitioning to a target CX flow." +}, "playbookInvocation": { "$ref": "GoogleCloudDialogflowCxV3PlaybookInvocation", "description": "Optional. Action performed on behalf of the agent by invoking a child playbook." }, +"playbookTransition": { +"$ref": "GoogleCloudDialogflowCxV3PlaybookTransition", +"description": "Optional. Action performed on behalf of the agent by transitioning to a target playbook." +}, "toolUse": { "$ref": "GoogleCloudDialogflowCxV3ToolUse", "description": "Optional. Action performed on behalf of the agent by calling a plugin tool." @@ -7502,6 +7510,13 @@ }, "type": "array" }, +"inputParameterDefinitions": { +"description": "Optional. Defined structured input parameters for this flow.", +"items": { +"$ref": "GoogleCloudDialogflowCxV3ParameterDefinition" +}, +"type": "array" +}, "knowledgeConnectorSettings": { "$ref": "GoogleCloudDialogflowCxV3KnowledgeConnectorSettings", "description": "Optional. Knowledge connector configuration." @@ -7522,6 +7537,13 @@ "$ref": "GoogleCloudDialogflowCxV3NluSettings", "description": "NLU related settings of the flow." }, +"outputParameterDefinitions": { +"description": "Optional. Defined structured output parameters for this flow.", +"items": { +"$ref": "GoogleCloudDialogflowCxV3ParameterDefinition" +}, +"type": "array" +}, "transitionRouteGroups": { "description": "A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format: `projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups.", "items": { @@ -7620,6 +7642,22 @@ }, "type": "object" }, +"GoogleCloudDialogflowCxV3FlowTransition": { +"description": "Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow.", +"id": "GoogleCloudDialogflowCxV3FlowTransition", +"properties": { +"displayName": { +"description": "Output only. The display name of the flow.", +"readOnly": true, +"type": "string" +}, +"flow": { +"description": "Required. The unique identifier of the flow. Format: `projects//locations//agents/`.", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudDialogflowCxV3FlowValidationResult": { "description": "The response message for Flows.GetFlowValidationResult.", "id": "GoogleCloudDialogflowCxV3FlowValidationResult", @@ -8432,6 +8470,35 @@ false }, "type": "object" }, +"GoogleCloudDialogflowCxV3InlineSchema": { +"description": "A type schema object that's specified inline.", +"id": "GoogleCloudDialogflowCxV3InlineSchema", +"properties": { +"items": { +"$ref": "GoogleCloudDialogflowCxV3TypeSchema", +"description": "Schema of the elements if this is an ARRAY type." +}, +"type": { +"description": "Data type of the schema.", +"enum": [ +"DATA_TYPE_UNSPECIFIED", +"STRING", +"NUMBER", +"BOOLEAN", +"ARRAY" +], +"enumDescriptions": [ +"Not specified.", +"Represents any string value.", +"Represents any number value.", +"Represents a boolean value.", +"Represents a repeated value." +], +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudDialogflowCxV3InlineSource": { "description": "Inline source for a Dialogflow operation that reads or imports objects (e.g. intents) into Dialogflow.", "id": "GoogleCloudDialogflowCxV3InlineSource", @@ -9506,6 +9573,48 @@ false }, "type": "object" }, +"GoogleCloudDialogflowCxV3ParameterDefinition": { +"description": "Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment.", +"id": "GoogleCloudDialogflowCxV3ParameterDefinition", +"properties": { +"description": { +"description": "Human-readable description of the parameter. Limited to 300 characters.", +"type": "string" +}, +"name": { +"description": "Required. Name of parameter.", +"type": "string" +}, +"type": { +"deprecated": true, +"description": "Type of parameter.", +"enum": [ +"PARAMETER_TYPE_UNSPECIFIED", +"STRING", +"NUMBER", +"BOOLEAN", +"NULL", +"OBJECT", +"LIST" +], +"enumDescriptions": [ +"Not specified. No validation will be performed.", +"Represents any string value.", +"Represents any number value.", +"Represents a boolean value.", +"Represents a null value.", +"Represents any object value.", +"Represents a repeated value." +], +"type": "string" +}, +"typeSchema": { +"$ref": "GoogleCloudDialogflowCxV3TypeSchema", +"description": "Optional. Type schema of parameter." +} +}, +"type": "object" +}, "GoogleCloudDialogflowCxV3Phrase": { "description": "Text input which can be used for prompt or banned phrases.", "id": "GoogleCloudDialogflowCxV3Phrase", @@ -9542,6 +9651,13 @@ false }, "type": "array" }, +"inputParameterDefinitions": { +"description": "Optional. Defined structured input parameters for this playbook.", +"items": { +"$ref": "GoogleCloudDialogflowCxV3ParameterDefinition" +}, +"type": "array" +}, "instruction": { "$ref": "GoogleCloudDialogflowCxV3PlaybookInstruction", "description": "Instruction to accomplish target goal." @@ -9554,6 +9670,27 @@ false "description": "The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`.", "type": "string" }, +"outputParameterDefinitions": { +"description": "Optional. Defined structured output parameters for this playbook.", +"items": { +"$ref": "GoogleCloudDialogflowCxV3ParameterDefinition" +}, +"type": "array" +}, +"playbookType": { +"description": "Optional. Type of the playbook.", +"enum": [ +"PLAYBOOK_TYPE_UNSPECIFIED", +"TASK", +"ROUTINE" +], +"enumDescriptions": [ +"Unspecified type. Default to TASK.", +"Task playbook.", +"Routine playbook." +], +"type": "string" +}, "referencedFlows": { "description": "Output only. The resource name of flows referenced by the current playbook in the instructions.", "items": { @@ -9761,6 +9898,22 @@ false }, "type": "object" }, +"GoogleCloudDialogflowCxV3PlaybookTransition": { +"description": "Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook.", +"id": "GoogleCloudDialogflowCxV3PlaybookTransition", +"properties": { +"displayName": { +"description": "Output only. The display name of the playbook.", +"readOnly": true, +"type": "string" +}, +"playbook": { +"description": "Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`.", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudDialogflowCxV3PlaybookVersion": { "description": "Playbook version is a snapshot of the playbook at certain timestamp.", "id": "GoogleCloudDialogflowCxV3PlaybookVersion", @@ -11707,6 +11860,36 @@ false }, "type": "object" }, +"GoogleCloudDialogflowCxV3TypeSchema": { +"description": "Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition.", +"id": "GoogleCloudDialogflowCxV3TypeSchema", +"properties": { +"inlineSchema": { +"$ref": "GoogleCloudDialogflowCxV3InlineSchema", +"description": "Set if this is an inline schema definition." +}, +"schemaReference": { +"$ref": "GoogleCloudDialogflowCxV3TypeSchemaSchemaReference", +"description": "Set if this is a schema reference." +} +}, +"type": "object" +}, +"GoogleCloudDialogflowCxV3TypeSchemaSchemaReference": { +"description": "A reference to the schema of an existing tool.", +"id": "GoogleCloudDialogflowCxV3TypeSchemaSchemaReference", +"properties": { +"schema": { +"description": "The name of the schema.", +"type": "string" +}, +"tool": { +"description": "The tool that contains this schema definition. Format: `projects//locations//agents//tools/`.", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudDialogflowCxV3UserUtterance": { "description": "UserUtterance represents one message sent by the customer.", "id": "GoogleCloudDialogflowCxV3UserUtterance", diff --git a/googleapiclient/discovery_cache/documents/dialogflow.v3beta1.json b/googleapiclient/discovery_cache/documents/dialogflow.v3beta1.json index 79adb4ba4db..d5b55e35773 100644 --- a/googleapiclient/discovery_cache/documents/dialogflow.v3beta1.json +++ b/googleapiclient/discovery_cache/documents/dialogflow.v3beta1.json @@ -5436,7 +5436,7 @@ } } }, -"revision": "20250627", +"revision": "20250804", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -10664,6 +10664,13 @@ }, "type": "array" }, +"inputParameterDefinitions": { +"description": "Optional. Defined structured input parameters for this flow.", +"items": { +"$ref": "GoogleCloudDialogflowCxV3beta1ParameterDefinition" +}, +"type": "array" +}, "knowledgeConnectorSettings": { "$ref": "GoogleCloudDialogflowCxV3beta1KnowledgeConnectorSettings", "description": "Optional. Knowledge connector configuration." @@ -10684,6 +10691,13 @@ "$ref": "GoogleCloudDialogflowCxV3beta1NluSettings", "description": "NLU related settings of the flow." }, +"outputParameterDefinitions": { +"description": "Optional. Defined structured output parameters for this flow.", +"items": { +"$ref": "GoogleCloudDialogflowCxV3beta1ParameterDefinition" +}, +"type": "array" +}, "transitionRouteGroups": { "description": "A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:`projects//locations//agents//flows//transitionRouteGroups/` or `projects//locations//agents//transitionRouteGroups/` for agent-level groups.", "items": { From b311188b61bfa9595d4f1f7433dc4f4740948294 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:59 +0000 Subject: [PATCH 17/32] feat(discoveryengine): update the api #### discoveryengine:v1 The following keys were added: - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.customerPolicy.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.enabledTools (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.generationConfig.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.webGroundingType.type (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1AssistantCustomerPolicy (Total Keys: 9) - schemas.GoogleCloudDiscoveryengineV1AssistantGenerationConfig (Total Keys: 7) - schemas.GoogleCloudDiscoveryengineV1AssistantToolInfo (Total Keys: 4) - schemas.GoogleCloudDiscoveryengineV1AssistantToolList (Total Keys: 4) - schemas.GoogleCloudDiscoveryengineV1ChunkDocumentMetadata.properties.mimeType.type (Total Keys: 1) #### discoveryengine:v1alpha The following keys were added: - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.customerPolicy.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.enabledTools (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.generationConfig.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.webGroundingType.type (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1AssistantCustomerPolicy (Total Keys: 9) - schemas.GoogleCloudDiscoveryengineV1AssistantGenerationConfig (Total Keys: 7) - schemas.GoogleCloudDiscoveryengineV1AssistantToolInfo (Total Keys: 4) - schemas.GoogleCloudDiscoveryengineV1AssistantToolList (Total Keys: 4) - schemas.GoogleCloudDiscoveryengineV1alphaAssistant.properties.customerPolicy.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1alphaAssistant.properties.enabledTools (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1alphaAssistant.properties.generationConfig.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1alphaAssistant.properties.webGroundingType.type (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1alphaAssistantCustomerPolicy (Total Keys: 9) - schemas.GoogleCloudDiscoveryengineV1alphaAssistantGenerationConfig (Total Keys: 7) - schemas.GoogleCloudDiscoveryengineV1alphaAssistantToolInfo (Total Keys: 4) - schemas.GoogleCloudDiscoveryengineV1alphaAssistantToolList (Total Keys: 4) - schemas.GoogleCloudDiscoveryengineV1alphaChunkDocumentMetadata.properties.mimeType.type (Total Keys: 1) #### discoveryengine:v1beta The following keys were added: - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.customerPolicy.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.enabledTools (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.generationConfig.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1Assistant.properties.webGroundingType.type (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1AssistantCustomerPolicy (Total Keys: 9) - schemas.GoogleCloudDiscoveryengineV1AssistantGenerationConfig (Total Keys: 7) - schemas.GoogleCloudDiscoveryengineV1AssistantToolInfo (Total Keys: 4) - schemas.GoogleCloudDiscoveryengineV1AssistantToolList (Total Keys: 4) - schemas.GoogleCloudDiscoveryengineV1betaAssistant.properties.customerPolicy.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1betaAssistant.properties.enabledTools (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1betaAssistant.properties.generationConfig.$ref (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1betaAssistant.properties.webGroundingType.type (Total Keys: 1) - schemas.GoogleCloudDiscoveryengineV1betaAssistantCustomerPolicy (Total Keys: 9) - schemas.GoogleCloudDiscoveryengineV1betaAssistantGenerationConfig (Total Keys: 7) - schemas.GoogleCloudDiscoveryengineV1betaAssistantToolInfo (Total Keys: 4) - schemas.GoogleCloudDiscoveryengineV1betaAssistantToolList (Total Keys: 4) - schemas.GoogleCloudDiscoveryengineV1betaChunkDocumentMetadata.properties.mimeType.type (Total Keys: 1) --- ....collections.dataStores.conversations.html | 1 + ...collections.dataStores.servingConfigs.html | 2 + ...ations.collections.engines.assistants.html | 78 +++++ ...ons.collections.engines.conversations.html | 1 + ...ns.collections.engines.servingConfigs.html | 2 + ...ts.locations.dataStores.conversations.html | 1 + ...s.locations.dataStores.servingConfigs.html | 2 + ....dataStores.branches.documents.chunks.html | 2 + ....collections.dataStores.conversations.html | 1 + ...collections.dataStores.servingConfigs.html | 4 + ...ations.collections.engines.assistants.html | 78 +++++ ...ons.collections.engines.conversations.html | 1 + ...ns.collections.engines.servingConfigs.html | 4 + ....dataStores.branches.documents.chunks.html | 2 + ...ts.locations.dataStores.conversations.html | 1 + ...s.locations.dataStores.servingConfigs.html | 4 + ...1alpha.projects.locations.evaluations.html | 8 +- ....collections.dataStores.conversations.html | 1 + ...collections.dataStores.servingConfigs.html | 4 + ...ations.collections.engines.assistants.html | 78 +++++ ...ons.collections.engines.conversations.html | 1 + ...ns.collections.engines.servingConfigs.html | 4 + ...ts.locations.dataStores.conversations.html | 1 + ...s.locations.dataStores.servingConfigs.html | 4 + ...v1beta.projects.locations.evaluations.html | 8 +- .../documents/discoveryengine.v1.json | 135 ++++++++- .../documents/discoveryengine.v1alpha.json | 272 +++++++++++++++++- .../documents/discoveryengine.v1beta.json | 272 +++++++++++++++++- 28 files changed, 953 insertions(+), 19 deletions(-) diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html index f451f961db8..448ff2be0fa 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html @@ -383,6 +383,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html index 16577f51f62..c4ad8f05378 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html @@ -1233,6 +1233,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -1603,6 +1604,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, 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 a8a6b201959..bf287d8a9ae 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.html @@ -107,7 +107,33 @@

Method Details

An object of the form: { # Discovery Engine Assistant resource. + "customerPolicy": { # Customer-defined policy for the assistant. # Optional. Customer policy for the assistant. + "bannedPhrases": [ # Optional. List of banned phrases. + { # Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused. + "ignoreDiacritics": True or False, # Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, "cafe" would match "café". + "matchType": "A String", # Optional. Match type for the banned phrase. + "phrase": "A String", # Required. The raw string content to be banned. + }, + ], + }, + "enabledTools": { # Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2, "transferTicket")], "gmail1ConnectorName": [(toolId3, "sendEmail"),..] } + "a_key": { # The enabled tools on a connector + "toolInfo": [ # The list of tools with corresponding tool information. + { # Information to identify a tool. + "toolDisplayName": "A String", # The display name of the tool. + "toolName": "A String", # The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here. + }, + ], + }, + }, + "generationConfig": { # Configuration for the generation of the assistant response. # Optional. Configuration for the generation of the assistant response. + "defaultLanguage": "A String", # The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected. + "systemInstruction": { # System instruction, also known as the prompt preamble for LLM calls. # System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions + "additionalSystemInstruction": "A String", # Optional. Additional system instruction that will be added to the default system instruction. + }, + }, "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. + "webGroundingType": "A String", # Optional. The type of web grounding to use. } @@ -121,7 +147,33 @@

Method Details

The object takes the form of: { # Discovery Engine Assistant resource. + "customerPolicy": { # Customer-defined policy for the assistant. # Optional. Customer policy for the assistant. + "bannedPhrases": [ # Optional. List of banned phrases. + { # Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused. + "ignoreDiacritics": True or False, # Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, "cafe" would match "café". + "matchType": "A String", # Optional. Match type for the banned phrase. + "phrase": "A String", # Required. The raw string content to be banned. + }, + ], + }, + "enabledTools": { # Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2, "transferTicket")], "gmail1ConnectorName": [(toolId3, "sendEmail"),..] } + "a_key": { # The enabled tools on a connector + "toolInfo": [ # The list of tools with corresponding tool information. + { # Information to identify a tool. + "toolDisplayName": "A String", # The display name of the tool. + "toolName": "A String", # The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here. + }, + ], + }, + }, + "generationConfig": { # Configuration for the generation of the assistant response. # Optional. Configuration for the generation of the assistant response. + "defaultLanguage": "A String", # The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected. + "systemInstruction": { # System instruction, also known as the prompt preamble for LLM calls. # System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions + "additionalSystemInstruction": "A String", # Optional. Additional system instruction that will be added to the default system instruction. + }, + }, "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. + "webGroundingType": "A String", # Optional. The type of web grounding to use. } updateMask: string, The list of fields to update. @@ -134,7 +186,33 @@

Method Details

An object of the form: { # Discovery Engine Assistant resource. + "customerPolicy": { # Customer-defined policy for the assistant. # Optional. Customer policy for the assistant. + "bannedPhrases": [ # Optional. List of banned phrases. + { # Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused. + "ignoreDiacritics": True or False, # Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, "cafe" would match "café". + "matchType": "A String", # Optional. Match type for the banned phrase. + "phrase": "A String", # Required. The raw string content to be banned. + }, + ], + }, + "enabledTools": { # Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2, "transferTicket")], "gmail1ConnectorName": [(toolId3, "sendEmail"),..] } + "a_key": { # The enabled tools on a connector + "toolInfo": [ # The list of tools with corresponding tool information. + { # Information to identify a tool. + "toolDisplayName": "A String", # The display name of the tool. + "toolName": "A String", # The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here. + }, + ], + }, + }, + "generationConfig": { # Configuration for the generation of the assistant response. # Optional. Configuration for the generation of the assistant response. + "defaultLanguage": "A String", # The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected. + "systemInstruction": { # System instruction, also known as the prompt preamble for LLM calls. # System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions + "additionalSystemInstruction": "A String", # Optional. Additional system instruction that will be added to the default system instruction. + }, + }, "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. + "webGroundingType": "A String", # Optional. The type of web grounding to use. } diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html index bf765cdc786..ab876e67172 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html @@ -383,6 +383,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html index 874b8f746e1..c31088315c7 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html @@ -1233,6 +1233,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -1603,6 +1604,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html index 82b0c838f1d..1316619afa0 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html @@ -383,6 +383,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html index 0887fcaefc9..85256123466 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html @@ -1233,6 +1233,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -1603,6 +1604,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.documents.chunks.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.documents.chunks.html index dd45e22752e..3abb779ec77 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.documents.chunks.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.documents.chunks.html @@ -135,6 +135,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -198,6 +199,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html index 93d7f71502c..4ca38a59363 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html @@ -452,6 +452,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html index 25aba20daf2..e54e70b37d4 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html @@ -1682,6 +1682,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -1792,6 +1793,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2265,6 +2267,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2375,6 +2378,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, 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 cdd5fa942dc..3b97b2c0c0b 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.html @@ -107,7 +107,33 @@

Method Details

An object of the form: { # Discovery Engine Assistant resource. + "customerPolicy": { # Customer-defined policy for the assistant. # Optional. Customer policy for the assistant. + "bannedPhrases": [ # Optional. List of banned phrases. + { # Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused. + "ignoreDiacritics": True or False, # Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, "cafe" would match "café". + "matchType": "A String", # Optional. Match type for the banned phrase. + "phrase": "A String", # Required. The raw string content to be banned. + }, + ], + }, + "enabledTools": { # Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2, "transferTicket")], "gmail1ConnectorName": [(toolId3, "sendEmail"),..] } + "a_key": { # The enabled tools on a connector + "toolInfo": [ # The list of tools with corresponding tool information. + { # Information to identify a tool. + "toolDisplayName": "A String", # The display name of the tool. + "toolName": "A String", # The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here. + }, + ], + }, + }, + "generationConfig": { # Configuration for the generation of the assistant response. # Optional. Configuration for the generation of the assistant response. + "defaultLanguage": "A String", # The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected. + "systemInstruction": { # System instruction, also known as the prompt preamble for LLM calls. # System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions + "additionalSystemInstruction": "A String", # Optional. Additional system instruction that will be added to the default system instruction. + }, + }, "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. + "webGroundingType": "A String", # Optional. The type of web grounding to use. } @@ -121,7 +147,33 @@

Method Details

The object takes the form of: { # Discovery Engine Assistant resource. + "customerPolicy": { # Customer-defined policy for the assistant. # Optional. Customer policy for the assistant. + "bannedPhrases": [ # Optional. List of banned phrases. + { # Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused. + "ignoreDiacritics": True or False, # Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, "cafe" would match "café". + "matchType": "A String", # Optional. Match type for the banned phrase. + "phrase": "A String", # Required. The raw string content to be banned. + }, + ], + }, + "enabledTools": { # Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2, "transferTicket")], "gmail1ConnectorName": [(toolId3, "sendEmail"),..] } + "a_key": { # The enabled tools on a connector + "toolInfo": [ # The list of tools with corresponding tool information. + { # Information to identify a tool. + "toolDisplayName": "A String", # The display name of the tool. + "toolName": "A String", # The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here. + }, + ], + }, + }, + "generationConfig": { # Configuration for the generation of the assistant response. # Optional. Configuration for the generation of the assistant response. + "defaultLanguage": "A String", # The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected. + "systemInstruction": { # System instruction, also known as the prompt preamble for LLM calls. # System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions + "additionalSystemInstruction": "A String", # Optional. Additional system instruction that will be added to the default system instruction. + }, + }, "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. + "webGroundingType": "A String", # Optional. The type of web grounding to use. } updateMask: string, The list of fields to update. @@ -134,7 +186,33 @@

Method Details

An object of the form: { # Discovery Engine Assistant resource. + "customerPolicy": { # Customer-defined policy for the assistant. # Optional. Customer policy for the assistant. + "bannedPhrases": [ # Optional. List of banned phrases. + { # Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused. + "ignoreDiacritics": True or False, # Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, "cafe" would match "café". + "matchType": "A String", # Optional. Match type for the banned phrase. + "phrase": "A String", # Required. The raw string content to be banned. + }, + ], + }, + "enabledTools": { # Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2, "transferTicket")], "gmail1ConnectorName": [(toolId3, "sendEmail"),..] } + "a_key": { # The enabled tools on a connector + "toolInfo": [ # The list of tools with corresponding tool information. + { # Information to identify a tool. + "toolDisplayName": "A String", # The display name of the tool. + "toolName": "A String", # The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here. + }, + ], + }, + }, + "generationConfig": { # Configuration for the generation of the assistant response. # Optional. Configuration for the generation of the assistant response. + "defaultLanguage": "A String", # The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected. + "systemInstruction": { # System instruction, also known as the prompt preamble for LLM calls. # System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions + "additionalSystemInstruction": "A String", # Optional. Additional system instruction that will be added to the default system instruction. + }, + }, "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. + "webGroundingType": "A String", # Optional. The type of web grounding to use. } diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html index 8c621c3366a..9acfa2b60eb 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html @@ -452,6 +452,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html index f2496b096d7..9c94133ab2b 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html @@ -1682,6 +1682,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -1792,6 +1793,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2265,6 +2267,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2375,6 +2378,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.documents.chunks.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.documents.chunks.html index 7289f777526..6eef3b744ba 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.documents.chunks.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.documents.chunks.html @@ -135,6 +135,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -198,6 +199,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html index 9db937a5f38..4a36325fab0 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html @@ -452,6 +452,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html index ea3c84838c9..89dba4ae63c 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html @@ -1682,6 +1682,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -1792,6 +1793,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2265,6 +2267,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2375,6 +2378,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html index 7bcb5ee38ab..8278422d2ec 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html @@ -677,8 +677,8 @@

Method Details

Args: parent: string, Required. The parent location resource name, such as `projects/{project}/locations/{location}`. If the caller does not have permission to list Evaluations under this location, regardless of whether or not this location exists, a `PERMISSION_DENIED` error is returned. (required) - pageSize: integer, Maximum number of Evaluations to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. - pageToken: string, A page token ListEvaluationsResponse.next_page_token, received from a previous EvaluationService.ListEvaluations call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluations must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned. + pageSize: integer, Optional. Maximum number of Evaluations to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. + pageToken: string, Optional. A page token ListEvaluationsResponse.next_page_token, received from a previous EvaluationService.ListEvaluations call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluations must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -955,8 +955,8 @@

Method Details

Args: evaluation: string, Required. The evaluation resource name, such as `projects/{project}/locations/{location}/evaluations/{evaluation}`. If the caller does not have permission to list ListEvaluationResultsResponse.EvaluationResult under this evaluation, regardless of whether or not this evaluation set exists, a `PERMISSION_DENIED` error is returned. (required) - pageSize: integer, Maximum number of ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. - pageToken: string, A page token ListEvaluationResultsResponse.next_page_token, received from a previous EvaluationService.ListEvaluationResults call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluationResults must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned. + pageSize: integer, Optional. Maximum number of ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. + pageToken: string, Optional. A page token ListEvaluationResultsResponse.next_page_token, received from a previous EvaluationService.ListEvaluationResults call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluationResults must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html index bd468cd1613..682985ba093 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html @@ -452,6 +452,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html index 19816f8bcaf..5bf4b3fda92 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html @@ -1643,6 +1643,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -1753,6 +1754,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2222,6 +2224,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2332,6 +2335,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, 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 ed992c9dfd1..42ca51dfa38 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.assistants.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.assistants.html @@ -107,7 +107,33 @@

Method Details

An object of the form: { # Discovery Engine Assistant resource. + "customerPolicy": { # Customer-defined policy for the assistant. # Optional. Customer policy for the assistant. + "bannedPhrases": [ # Optional. List of banned phrases. + { # Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused. + "ignoreDiacritics": True or False, # Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, "cafe" would match "café". + "matchType": "A String", # Optional. Match type for the banned phrase. + "phrase": "A String", # Required. The raw string content to be banned. + }, + ], + }, + "enabledTools": { # Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2, "transferTicket")], "gmail1ConnectorName": [(toolId3, "sendEmail"),..] } + "a_key": { # The enabled tools on a connector + "toolInfo": [ # The list of tools with corresponding tool information. + { # Information to identify a tool. + "toolDisplayName": "A String", # The display name of the tool. + "toolName": "A String", # The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here. + }, + ], + }, + }, + "generationConfig": { # Configuration for the generation of the assistant response. # Optional. Configuration for the generation of the assistant response. + "defaultLanguage": "A String", # The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected. + "systemInstruction": { # System instruction, also known as the prompt preamble for LLM calls. # System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions + "additionalSystemInstruction": "A String", # Optional. Additional system instruction that will be added to the default system instruction. + }, + }, "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. + "webGroundingType": "A String", # Optional. The type of web grounding to use. } @@ -121,7 +147,33 @@

Method Details

The object takes the form of: { # Discovery Engine Assistant resource. + "customerPolicy": { # Customer-defined policy for the assistant. # Optional. Customer policy for the assistant. + "bannedPhrases": [ # Optional. List of banned phrases. + { # Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused. + "ignoreDiacritics": True or False, # Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, "cafe" would match "café". + "matchType": "A String", # Optional. Match type for the banned phrase. + "phrase": "A String", # Required. The raw string content to be banned. + }, + ], + }, + "enabledTools": { # Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2, "transferTicket")], "gmail1ConnectorName": [(toolId3, "sendEmail"),..] } + "a_key": { # The enabled tools on a connector + "toolInfo": [ # The list of tools with corresponding tool information. + { # Information to identify a tool. + "toolDisplayName": "A String", # The display name of the tool. + "toolName": "A String", # The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here. + }, + ], + }, + }, + "generationConfig": { # Configuration for the generation of the assistant response. # Optional. Configuration for the generation of the assistant response. + "defaultLanguage": "A String", # The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected. + "systemInstruction": { # System instruction, also known as the prompt preamble for LLM calls. # System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions + "additionalSystemInstruction": "A String", # Optional. Additional system instruction that will be added to the default system instruction. + }, + }, "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. + "webGroundingType": "A String", # Optional. The type of web grounding to use. } updateMask: string, The list of fields to update. @@ -134,7 +186,33 @@

Method Details

An object of the form: { # Discovery Engine Assistant resource. + "customerPolicy": { # Customer-defined policy for the assistant. # Optional. Customer policy for the assistant. + "bannedPhrases": [ # Optional. List of banned phrases. + { # Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused. + "ignoreDiacritics": True or False, # Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, "cafe" would match "café". + "matchType": "A String", # Optional. Match type for the banned phrase. + "phrase": "A String", # Required. The raw string content to be banned. + }, + ], + }, + "enabledTools": { # Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2, "transferTicket")], "gmail1ConnectorName": [(toolId3, "sendEmail"),..] } + "a_key": { # The enabled tools on a connector + "toolInfo": [ # The list of tools with corresponding tool information. + { # Information to identify a tool. + "toolDisplayName": "A String", # The display name of the tool. + "toolName": "A String", # The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here. + }, + ], + }, + }, + "generationConfig": { # Configuration for the generation of the assistant response. # Optional. Configuration for the generation of the assistant response. + "defaultLanguage": "A String", # The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected. + "systemInstruction": { # System instruction, also known as the prompt preamble for LLM calls. # System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions + "additionalSystemInstruction": "A String", # Optional. Additional system instruction that will be added to the default system instruction. + }, + }, "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. + "webGroundingType": "A String", # Optional. The type of web grounding to use. } diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html index 2e3426ca3bb..9afdd908499 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html @@ -452,6 +452,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html index e91a80c3eb0..89dc0e49520 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html @@ -1643,6 +1643,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -1753,6 +1754,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2222,6 +2224,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2332,6 +2335,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html index 58c76c5969c..fce43749e7b 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html @@ -452,6 +452,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html index 1b12bd4bd91..c374e04174f 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html @@ -1643,6 +1643,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -1753,6 +1754,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2222,6 +2224,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, @@ -2332,6 +2335,7 @@

Method Details

"a_key": "", # Properties of the object. }, "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk. + "mimeType": "A String", # The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml. "structData": { # Data representation. The structured JSON data for the document. It should conform to the registered Schema or an `INVALID_ARGUMENT` error is thrown. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html index 4ab4fbfc3c8..2e1e6fd0a4c 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html @@ -669,8 +669,8 @@

Method Details

Args: parent: string, Required. The parent location resource name, such as `projects/{project}/locations/{location}`. If the caller does not have permission to list Evaluations under this location, regardless of whether or not this location exists, a `PERMISSION_DENIED` error is returned. (required) - pageSize: integer, Maximum number of Evaluations to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. - pageToken: string, A page token ListEvaluationsResponse.next_page_token, received from a previous EvaluationService.ListEvaluations call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluations must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned. + pageSize: integer, Optional. Maximum number of Evaluations to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. + pageToken: string, Optional. A page token ListEvaluationsResponse.next_page_token, received from a previous EvaluationService.ListEvaluations call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluations must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -943,8 +943,8 @@

Method Details

Args: evaluation: string, Required. The evaluation resource name, such as `projects/{project}/locations/{location}/evaluations/{evaluation}`. If the caller does not have permission to list ListEvaluationResultsResponse.EvaluationResult under this evaluation, regardless of whether or not this evaluation set exists, a `PERMISSION_DENIED` error is returned. (required) - pageSize: integer, Maximum number of ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. - pageToken: string, A page token ListEvaluationResultsResponse.next_page_token, received from a previous EvaluationService.ListEvaluationResults call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluationResults must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned. + pageSize: integer, Optional. Maximum number of ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned. + pageToken: string, Optional. A page token ListEvaluationResultsResponse.next_page_token, received from a previous EvaluationService.ListEvaluationResults call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluationResults must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json index f75adc6b040..e1b198b197b 100644 --- a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json +++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json @@ -7291,7 +7291,7 @@ } } }, -"revision": "20250728", +"revision": "20250803", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GdataBlobstore2Info": { @@ -9776,9 +9776,40 @@ "description": "Discovery Engine Assistant resource.", "id": "GoogleCloudDiscoveryengineV1Assistant", "properties": { +"customerPolicy": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicy", +"description": "Optional. Customer policy for the assistant." +}, +"enabledTools": { +"additionalProperties": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantToolList" +}, +"description": "Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example \"projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {\"jira1ConnectorName\": [(toolId1, \"createTicket\"), (toolId2, \"transferTicket\")], \"gmail1ConnectorName\": [(toolId3, \"sendEmail\"),..] }", +"type": "object" +}, +"generationConfig": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantGenerationConfig", +"description": "Optional. Configuration for the generation of the assistant response." +}, "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" +}, +"webGroundingType": { +"description": "Optional. The type of web grounding to use.", +"enum": [ +"WEB_GROUNDING_TYPE_UNSPECIFIED", +"WEB_GROUNDING_TYPE_DISABLED", +"WEB_GROUNDING_TYPE_GOOGLE_SEARCH", +"WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH" +], +"enumDescriptions": [ +"Default, unspecified setting. This is the same as disabled.", +"Web grounding is disabled.", +"Grounding with Google Search is enabled.", +"Grounding with Enterprise Web Search is enabled." +], +"type": "string" } }, "type": "object" @@ -9887,6 +9918,75 @@ }, "type": "object" }, +"GoogleCloudDiscoveryengineV1AssistantCustomerPolicy": { +"description": "Customer-defined policy for the assistant.", +"id": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicy", +"properties": { +"bannedPhrases": { +"description": "Optional. List of banned phrases.", +"items": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicyBannedPhrase" +}, +"type": "array" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantCustomerPolicyBannedPhrase": { +"description": "Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused.", +"id": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicyBannedPhrase", +"properties": { +"ignoreDiacritics": { +"description": "Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, \"cafe\" would match \"caf\u00e9\".", +"type": "boolean" +}, +"matchType": { +"description": "Optional. Match type for the banned phrase.", +"enum": [ +"BANNED_PHRASE_MATCH_TYPE_UNSPECIFIED", +"SIMPLE_STRING_MATCH", +"WORD_BOUNDARY_STRING_MATCH" +], +"enumDescriptions": [ +"Defaults to SIMPLE_STRING_MATCH.", +"The banned phrase matches if it is found anywhere in the text as an exact substring.", +"Banned phrase only matches if the pattern found in the text is surrounded by word delimiters. The phrase itself may still contain word delimiters." +], +"type": "string" +}, +"phrase": { +"description": "Required. The raw string content to be banned.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantGenerationConfig": { +"description": "Configuration for the generation of the assistant response.", +"id": "GoogleCloudDiscoveryengineV1AssistantGenerationConfig", +"properties": { +"defaultLanguage": { +"description": "The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected.", +"type": "string" +}, +"systemInstruction": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantGenerationConfigSystemInstruction", +"description": "System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantGenerationConfigSystemInstruction": { +"description": "System instruction, also known as the prompt preamble for LLM calls.", +"id": "GoogleCloudDiscoveryengineV1AssistantGenerationConfigSystemInstruction", +"properties": { +"additionalSystemInstruction": { +"description": "Optional. Additional system instruction that will be added to the default system instruction.", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudDiscoveryengineV1AssistantGroundedContent": { "description": "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.", "id": "GoogleCloudDiscoveryengineV1AssistantGroundedContent", @@ -9999,6 +10099,35 @@ }, "type": "object" }, +"GoogleCloudDiscoveryengineV1AssistantToolInfo": { +"description": "Information to identify a tool.", +"id": "GoogleCloudDiscoveryengineV1AssistantToolInfo", +"properties": { +"toolDisplayName": { +"description": "The display name of the tool.", +"type": "string" +}, +"toolName": { +"description": "The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantToolList": { +"description": "The enabled tools on a connector", +"id": "GoogleCloudDiscoveryengineV1AssistantToolList", +"properties": { +"toolInfo": { +"description": "The list of tools with corresponding tool information.", +"items": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantToolInfo" +}, +"type": "array" +} +}, +"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", @@ -10619,6 +10748,10 @@ "description": "Document metadata contains the information of the document of the current chunk.", "id": "GoogleCloudDiscoveryengineV1ChunkDocumentMetadata", "properties": { +"mimeType": { +"description": "The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml.", +"type": "string" +}, "structData": { "additionalProperties": { "description": "Properties of the object.", diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json index bcc05eea8ab..1be2aba619b 100644 --- a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json @@ -8049,13 +8049,13 @@ ], "parameters": { "pageSize": { -"description": "Maximum number of Evaluations to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", +"description": "Optional. Maximum number of Evaluations to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { -"description": "A page token ListEvaluationsResponse.next_page_token, received from a previous EvaluationService.ListEvaluations call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluations must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned.", +"description": "Optional. A page token ListEvaluationsResponse.next_page_token, received from a previous EvaluationService.ListEvaluations call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluations must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned.", "location": "query", "type": "string" }, @@ -8092,13 +8092,13 @@ "type": "string" }, "pageSize": { -"description": "Maximum number of ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", +"description": "Optional. Maximum number of ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { -"description": "A page token ListEvaluationResultsResponse.next_page_token, received from a previous EvaluationService.ListEvaluationResults call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluationResults must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned.", +"description": "Optional. A page token ListEvaluationResultsResponse.next_page_token, received from a previous EvaluationService.ListEvaluationResults call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluationResults must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned.", "location": "query", "type": "string" } @@ -9452,7 +9452,7 @@ } } }, -"revision": "20250728", +"revision": "20250803", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "ApiservingMediaRequestInfo": { @@ -10533,9 +10533,138 @@ "description": "Discovery Engine Assistant resource.", "id": "GoogleCloudDiscoveryengineV1Assistant", "properties": { +"customerPolicy": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicy", +"description": "Optional. Customer policy for the assistant." +}, +"enabledTools": { +"additionalProperties": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantToolList" +}, +"description": "Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example \"projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {\"jira1ConnectorName\": [(toolId1, \"createTicket\"), (toolId2, \"transferTicket\")], \"gmail1ConnectorName\": [(toolId3, \"sendEmail\"),..] }", +"type": "object" +}, +"generationConfig": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantGenerationConfig", +"description": "Optional. Configuration for the generation of the assistant response." +}, "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" +}, +"webGroundingType": { +"description": "Optional. The type of web grounding to use.", +"enum": [ +"WEB_GROUNDING_TYPE_UNSPECIFIED", +"WEB_GROUNDING_TYPE_DISABLED", +"WEB_GROUNDING_TYPE_GOOGLE_SEARCH", +"WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH" +], +"enumDescriptions": [ +"Default, unspecified setting. This is the same as disabled.", +"Web grounding is disabled.", +"Grounding with Google Search is enabled.", +"Grounding with Enterprise Web Search is enabled." +], +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantCustomerPolicy": { +"description": "Customer-defined policy for the assistant.", +"id": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicy", +"properties": { +"bannedPhrases": { +"description": "Optional. List of banned phrases.", +"items": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicyBannedPhrase" +}, +"type": "array" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantCustomerPolicyBannedPhrase": { +"description": "Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused.", +"id": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicyBannedPhrase", +"properties": { +"ignoreDiacritics": { +"description": "Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, \"cafe\" would match \"caf\u00e9\".", +"type": "boolean" +}, +"matchType": { +"description": "Optional. Match type for the banned phrase.", +"enum": [ +"BANNED_PHRASE_MATCH_TYPE_UNSPECIFIED", +"SIMPLE_STRING_MATCH", +"WORD_BOUNDARY_STRING_MATCH" +], +"enumDescriptions": [ +"Defaults to SIMPLE_STRING_MATCH.", +"The banned phrase matches if it is found anywhere in the text as an exact substring.", +"Banned phrase only matches if the pattern found in the text is surrounded by word delimiters. The phrase itself may still contain word delimiters." +], +"type": "string" +}, +"phrase": { +"description": "Required. The raw string content to be banned.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantGenerationConfig": { +"description": "Configuration for the generation of the assistant response.", +"id": "GoogleCloudDiscoveryengineV1AssistantGenerationConfig", +"properties": { +"defaultLanguage": { +"description": "The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected.", +"type": "string" +}, +"systemInstruction": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantGenerationConfigSystemInstruction", +"description": "System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantGenerationConfigSystemInstruction": { +"description": "System instruction, also known as the prompt preamble for LLM calls.", +"id": "GoogleCloudDiscoveryengineV1AssistantGenerationConfigSystemInstruction", +"properties": { +"additionalSystemInstruction": { +"description": "Optional. Additional system instruction that will be added to the default system instruction.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantToolInfo": { +"description": "Information to identify a tool.", +"id": "GoogleCloudDiscoveryengineV1AssistantToolInfo", +"properties": { +"toolDisplayName": { +"description": "The display name of the tool.", +"type": "string" +}, +"toolName": { +"description": "The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantToolList": { +"description": "The enabled tools on a connector", +"id": "GoogleCloudDiscoveryengineV1AssistantToolList", +"properties": { +"toolInfo": { +"description": "The list of tools with corresponding tool information.", +"items": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantToolInfo" +}, +"type": "array" } }, "type": "object" @@ -14940,9 +15069,40 @@ "description": "Discovery Engine Assistant resource.", "id": "GoogleCloudDiscoveryengineV1alphaAssistant", "properties": { +"customerPolicy": { +"$ref": "GoogleCloudDiscoveryengineV1alphaAssistantCustomerPolicy", +"description": "Optional. Customer policy for the assistant." +}, +"enabledTools": { +"additionalProperties": { +"$ref": "GoogleCloudDiscoveryengineV1alphaAssistantToolList" +}, +"description": "Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example \"projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {\"jira1ConnectorName\": [(toolId1, \"createTicket\"), (toolId2, \"transferTicket\")], \"gmail1ConnectorName\": [(toolId3, \"sendEmail\"),..] }", +"type": "object" +}, +"generationConfig": { +"$ref": "GoogleCloudDiscoveryengineV1alphaAssistantGenerationConfig", +"description": "Optional. Configuration for the generation of the assistant response." +}, "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" +}, +"webGroundingType": { +"description": "Optional. The type of web grounding to use.", +"enum": [ +"WEB_GROUNDING_TYPE_UNSPECIFIED", +"WEB_GROUNDING_TYPE_DISABLED", +"WEB_GROUNDING_TYPE_GOOGLE_SEARCH", +"WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH" +], +"enumDescriptions": [ +"Default, unspecified setting. This is the same as disabled.", +"Web grounding is disabled.", +"Grounding with Google Search is enabled.", +"Grounding with Enterprise Web Search is enabled." +], +"type": "string" } }, "type": "object" @@ -15051,6 +15211,75 @@ }, "type": "object" }, +"GoogleCloudDiscoveryengineV1alphaAssistantCustomerPolicy": { +"description": "Customer-defined policy for the assistant.", +"id": "GoogleCloudDiscoveryengineV1alphaAssistantCustomerPolicy", +"properties": { +"bannedPhrases": { +"description": "Optional. List of banned phrases.", +"items": { +"$ref": "GoogleCloudDiscoveryengineV1alphaAssistantCustomerPolicyBannedPhrase" +}, +"type": "array" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1alphaAssistantCustomerPolicyBannedPhrase": { +"description": "Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused.", +"id": "GoogleCloudDiscoveryengineV1alphaAssistantCustomerPolicyBannedPhrase", +"properties": { +"ignoreDiacritics": { +"description": "Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, \"cafe\" would match \"caf\u00e9\".", +"type": "boolean" +}, +"matchType": { +"description": "Optional. Match type for the banned phrase.", +"enum": [ +"BANNED_PHRASE_MATCH_TYPE_UNSPECIFIED", +"SIMPLE_STRING_MATCH", +"WORD_BOUNDARY_STRING_MATCH" +], +"enumDescriptions": [ +"Defaults to SIMPLE_STRING_MATCH.", +"The banned phrase matches if it is found anywhere in the text as an exact substring.", +"Banned phrase only matches if the pattern found in the text is surrounded by word delimiters. The phrase itself may still contain word delimiters." +], +"type": "string" +}, +"phrase": { +"description": "Required. The raw string content to be banned.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1alphaAssistantGenerationConfig": { +"description": "Configuration for the generation of the assistant response.", +"id": "GoogleCloudDiscoveryengineV1alphaAssistantGenerationConfig", +"properties": { +"defaultLanguage": { +"description": "The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected.", +"type": "string" +}, +"systemInstruction": { +"$ref": "GoogleCloudDiscoveryengineV1alphaAssistantGenerationConfigSystemInstruction", +"description": "System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1alphaAssistantGenerationConfigSystemInstruction": { +"description": "System instruction, also known as the prompt preamble for LLM calls.", +"id": "GoogleCloudDiscoveryengineV1alphaAssistantGenerationConfigSystemInstruction", +"properties": { +"additionalSystemInstruction": { +"description": "Optional. Additional system instruction that will be added to the default system instruction.", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContent": { "description": "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.", "id": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContent", @@ -15163,6 +15392,35 @@ }, "type": "object" }, +"GoogleCloudDiscoveryengineV1alphaAssistantToolInfo": { +"description": "Information to identify a tool.", +"id": "GoogleCloudDiscoveryengineV1alphaAssistantToolInfo", +"properties": { +"toolDisplayName": { +"description": "The display name of the tool.", +"type": "string" +}, +"toolName": { +"description": "The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1alphaAssistantToolList": { +"description": "The enabled tools on a connector", +"id": "GoogleCloudDiscoveryengineV1alphaAssistantToolList", +"properties": { +"toolInfo": { +"description": "The list of tools with corresponding tool information.", +"items": { +"$ref": "GoogleCloudDiscoveryengineV1alphaAssistantToolInfo" +}, +"type": "array" +} +}, +"type": "object" +}, "GoogleCloudDiscoveryengineV1alphaBAPConfig": { "description": "The configuration for the BAP connector.", "id": "GoogleCloudDiscoveryengineV1alphaBAPConfig", @@ -15901,6 +16159,10 @@ "description": "Document metadata contains the information of the document of the current chunk.", "id": "GoogleCloudDiscoveryengineV1alphaChunkDocumentMetadata", "properties": { +"mimeType": { +"description": "The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml.", +"type": "string" +}, "structData": { "additionalProperties": { "description": "Properties of the object.", diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json index f024ea920bb..c465400b089 100644 --- a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json +++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json @@ -6955,13 +6955,13 @@ ], "parameters": { "pageSize": { -"description": "Maximum number of Evaluations to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", +"description": "Optional. Maximum number of Evaluations to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { -"description": "A page token ListEvaluationsResponse.next_page_token, received from a previous EvaluationService.ListEvaluations call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluations must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned.", +"description": "Optional. A page token ListEvaluationsResponse.next_page_token, received from a previous EvaluationService.ListEvaluations call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluations must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned.", "location": "query", "type": "string" }, @@ -6998,13 +6998,13 @@ "type": "string" }, "pageSize": { -"description": "Maximum number of ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", +"description": "Optional. Maximum number of ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { -"description": "A page token ListEvaluationResultsResponse.next_page_token, received from a previous EvaluationService.ListEvaluationResults call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluationResults must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned.", +"description": "Optional. A page token ListEvaluationResultsResponse.next_page_token, received from a previous EvaluationService.ListEvaluationResults call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to EvaluationService.ListEvaluationResults must match the call that provided the page token. Otherwise, an `INVALID_ARGUMENT` error is returned.", "location": "query", "type": "string" } @@ -8147,7 +8147,7 @@ } } }, -"revision": "20250728", +"revision": "20250803", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GdataBlobstore2Info": { @@ -9066,9 +9066,138 @@ "description": "Discovery Engine Assistant resource.", "id": "GoogleCloudDiscoveryengineV1Assistant", "properties": { +"customerPolicy": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicy", +"description": "Optional. Customer policy for the assistant." +}, +"enabledTools": { +"additionalProperties": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantToolList" +}, +"description": "Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example \"projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {\"jira1ConnectorName\": [(toolId1, \"createTicket\"), (toolId2, \"transferTicket\")], \"gmail1ConnectorName\": [(toolId3, \"sendEmail\"),..] }", +"type": "object" +}, +"generationConfig": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantGenerationConfig", +"description": "Optional. Configuration for the generation of the assistant response." +}, "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" +}, +"webGroundingType": { +"description": "Optional. The type of web grounding to use.", +"enum": [ +"WEB_GROUNDING_TYPE_UNSPECIFIED", +"WEB_GROUNDING_TYPE_DISABLED", +"WEB_GROUNDING_TYPE_GOOGLE_SEARCH", +"WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH" +], +"enumDescriptions": [ +"Default, unspecified setting. This is the same as disabled.", +"Web grounding is disabled.", +"Grounding with Google Search is enabled.", +"Grounding with Enterprise Web Search is enabled." +], +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantCustomerPolicy": { +"description": "Customer-defined policy for the assistant.", +"id": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicy", +"properties": { +"bannedPhrases": { +"description": "Optional. List of banned phrases.", +"items": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicyBannedPhrase" +}, +"type": "array" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantCustomerPolicyBannedPhrase": { +"description": "Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused.", +"id": "GoogleCloudDiscoveryengineV1AssistantCustomerPolicyBannedPhrase", +"properties": { +"ignoreDiacritics": { +"description": "Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, \"cafe\" would match \"caf\u00e9\".", +"type": "boolean" +}, +"matchType": { +"description": "Optional. Match type for the banned phrase.", +"enum": [ +"BANNED_PHRASE_MATCH_TYPE_UNSPECIFIED", +"SIMPLE_STRING_MATCH", +"WORD_BOUNDARY_STRING_MATCH" +], +"enumDescriptions": [ +"Defaults to SIMPLE_STRING_MATCH.", +"The banned phrase matches if it is found anywhere in the text as an exact substring.", +"Banned phrase only matches if the pattern found in the text is surrounded by word delimiters. The phrase itself may still contain word delimiters." +], +"type": "string" +}, +"phrase": { +"description": "Required. The raw string content to be banned.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantGenerationConfig": { +"description": "Configuration for the generation of the assistant response.", +"id": "GoogleCloudDiscoveryengineV1AssistantGenerationConfig", +"properties": { +"defaultLanguage": { +"description": "The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected.", +"type": "string" +}, +"systemInstruction": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantGenerationConfigSystemInstruction", +"description": "System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantGenerationConfigSystemInstruction": { +"description": "System instruction, also known as the prompt preamble for LLM calls.", +"id": "GoogleCloudDiscoveryengineV1AssistantGenerationConfigSystemInstruction", +"properties": { +"additionalSystemInstruction": { +"description": "Optional. Additional system instruction that will be added to the default system instruction.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantToolInfo": { +"description": "Information to identify a tool.", +"id": "GoogleCloudDiscoveryengineV1AssistantToolInfo", +"properties": { +"toolDisplayName": { +"description": "The display name of the tool.", +"type": "string" +}, +"toolName": { +"description": "The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1AssistantToolList": { +"description": "The enabled tools on a connector", +"id": "GoogleCloudDiscoveryengineV1AssistantToolList", +"properties": { +"toolInfo": { +"description": "The list of tools with corresponding tool information.", +"items": { +"$ref": "GoogleCloudDiscoveryengineV1AssistantToolInfo" +}, +"type": "array" } }, "type": "object" @@ -19247,9 +19376,40 @@ false "description": "Discovery Engine Assistant resource.", "id": "GoogleCloudDiscoveryengineV1betaAssistant", "properties": { +"customerPolicy": { +"$ref": "GoogleCloudDiscoveryengineV1betaAssistantCustomerPolicy", +"description": "Optional. Customer policy for the assistant." +}, +"enabledTools": { +"additionalProperties": { +"$ref": "GoogleCloudDiscoveryengineV1betaAssistantToolList" +}, +"description": "Optional. Note: not implemented yet. Use enabled_actions instead. The enabled tools on this assistant. The keys are connector name, for example \"projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {\"jira1ConnectorName\": [(toolId1, \"createTicket\"), (toolId2, \"transferTicket\")], \"gmail1ConnectorName\": [(toolId3, \"sendEmail\"),..] }", +"type": "object" +}, +"generationConfig": { +"$ref": "GoogleCloudDiscoveryengineV1betaAssistantGenerationConfig", +"description": "Optional. Configuration for the generation of the assistant response." +}, "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" +}, +"webGroundingType": { +"description": "Optional. The type of web grounding to use.", +"enum": [ +"WEB_GROUNDING_TYPE_UNSPECIFIED", +"WEB_GROUNDING_TYPE_DISABLED", +"WEB_GROUNDING_TYPE_GOOGLE_SEARCH", +"WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH" +], +"enumDescriptions": [ +"Default, unspecified setting. This is the same as disabled.", +"Web grounding is disabled.", +"Grounding with Google Search is enabled.", +"Grounding with Enterprise Web Search is enabled." +], +"type": "string" } }, "type": "object" @@ -19358,6 +19518,75 @@ false }, "type": "object" }, +"GoogleCloudDiscoveryengineV1betaAssistantCustomerPolicy": { +"description": "Customer-defined policy for the assistant.", +"id": "GoogleCloudDiscoveryengineV1betaAssistantCustomerPolicy", +"properties": { +"bannedPhrases": { +"description": "Optional. List of banned phrases.", +"items": { +"$ref": "GoogleCloudDiscoveryengineV1betaAssistantCustomerPolicyBannedPhrase" +}, +"type": "array" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1betaAssistantCustomerPolicyBannedPhrase": { +"description": "Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused.", +"id": "GoogleCloudDiscoveryengineV1betaAssistantCustomerPolicyBannedPhrase", +"properties": { +"ignoreDiacritics": { +"description": "Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, \"cafe\" would match \"caf\u00e9\".", +"type": "boolean" +}, +"matchType": { +"description": "Optional. Match type for the banned phrase.", +"enum": [ +"BANNED_PHRASE_MATCH_TYPE_UNSPECIFIED", +"SIMPLE_STRING_MATCH", +"WORD_BOUNDARY_STRING_MATCH" +], +"enumDescriptions": [ +"Defaults to SIMPLE_STRING_MATCH.", +"The banned phrase matches if it is found anywhere in the text as an exact substring.", +"Banned phrase only matches if the pattern found in the text is surrounded by word delimiters. The phrase itself may still contain word delimiters." +], +"type": "string" +}, +"phrase": { +"description": "Required. The raw string content to be banned.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1betaAssistantGenerationConfig": { +"description": "Configuration for the generation of the assistant response.", +"id": "GoogleCloudDiscoveryengineV1betaAssistantGenerationConfig", +"properties": { +"defaultLanguage": { +"description": "The default language to use for the generation of the assistant response. Use an ISO 639-1 language code such as `en`. If not specified, the language will be automatically detected.", +"type": "string" +}, +"systemInstruction": { +"$ref": "GoogleCloudDiscoveryengineV1betaAssistantGenerationConfigSystemInstruction", +"description": "System instruction, also known as the prompt preamble for LLM calls. See also https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1betaAssistantGenerationConfigSystemInstruction": { +"description": "System instruction, also known as the prompt preamble for LLM calls.", +"id": "GoogleCloudDiscoveryengineV1betaAssistantGenerationConfigSystemInstruction", +"properties": { +"additionalSystemInstruction": { +"description": "Optional. Additional system instruction that will be added to the default system instruction.", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudDiscoveryengineV1betaAssistantGroundedContent": { "description": "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.", "id": "GoogleCloudDiscoveryengineV1betaAssistantGroundedContent", @@ -19470,6 +19699,35 @@ false }, "type": "object" }, +"GoogleCloudDiscoveryengineV1betaAssistantToolInfo": { +"description": "Information to identify a tool.", +"id": "GoogleCloudDiscoveryengineV1betaAssistantToolInfo", +"properties": { +"toolDisplayName": { +"description": "The display name of the tool.", +"type": "string" +}, +"toolName": { +"description": "The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using `action` in the DataConnectorService apis, but they are the same as the `tool` here.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudDiscoveryengineV1betaAssistantToolList": { +"description": "The enabled tools on a connector", +"id": "GoogleCloudDiscoveryengineV1betaAssistantToolList", +"properties": { +"toolInfo": { +"description": "The list of tools with corresponding tool information.", +"items": { +"$ref": "GoogleCloudDiscoveryengineV1betaAssistantToolInfo" +}, +"type": "array" +} +}, +"type": "object" +}, "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata": { "description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata", @@ -20090,6 +20348,10 @@ false "description": "Document metadata contains the information of the document of the current chunk.", "id": "GoogleCloudDiscoveryengineV1betaChunkDocumentMetadata", "properties": { +"mimeType": { +"description": "The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml.", +"type": "string" +}, "structData": { "additionalProperties": { "description": "Properties of the object.", From 7e84e90366cbbdc55ed601e7a57e18d551fb4986 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:09:59 +0000 Subject: [PATCH 18/32] feat(displayvideo): update the api #### displayvideo:v4 The following keys were added: - schemas.CustomBiddingAlgorithm.properties.thirdPartyOptimizationPartner.type (Total Keys: 1) --- .../displayvideo_v4.customBiddingAlgorithms.html | 6 ++++++ .../documents/displayvideo.v4.json | 16 +++++++++++++++- 2 files changed, 21 insertions(+), 1 deletion(-) diff --git a/docs/dyn/displayvideo_v4.customBiddingAlgorithms.html b/docs/dyn/displayvideo_v4.customBiddingAlgorithms.html index 04d452b1d5d..f6d2f0e8c42 100644 --- a/docs/dyn/displayvideo_v4.customBiddingAlgorithms.html +++ b/docs/dyn/displayvideo_v4.customBiddingAlgorithms.html @@ -140,6 +140,7 @@

Method Details

"sharedAdvertiserIds": [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor). "A String", ], + "thirdPartyOptimizationPartner": "A String", # Optional. Immutable. Designates the third party optimization partner that manages this algorithm. } x__xgafv: string, V1 error format. @@ -168,6 +169,7 @@

Method Details

"sharedAdvertiserIds": [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor). "A String", ], + "thirdPartyOptimizationPartner": "A String", # Optional. Immutable. Designates the third party optimization partner that manages this algorithm. } @@ -205,6 +207,7 @@

Method Details

"sharedAdvertiserIds": [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor). "A String", ], + "thirdPartyOptimizationPartner": "A String", # Optional. Immutable. Designates the third party optimization partner that manages this algorithm. } @@ -247,6 +250,7 @@

Method Details

"sharedAdvertiserIds": [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor). "A String", ], + "thirdPartyOptimizationPartner": "A String", # Optional. Immutable. Designates the third party optimization partner that manages this algorithm. }, ], "nextPageToken": "A String", # A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to `ListCustomBiddingAlgorithmsRequest` method to retrieve the next page of results. If this field is null, it means this is the last page. @@ -294,6 +298,7 @@

Method Details

"sharedAdvertiserIds": [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor). "A String", ], + "thirdPartyOptimizationPartner": "A String", # Optional. Immutable. Designates the third party optimization partner that manages this algorithm. } updateMask: string, Required. The mask to control which fields to update. @@ -323,6 +328,7 @@

Method Details

"sharedAdvertiserIds": [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor). "A String", ], + "thirdPartyOptimizationPartner": "A String", # Optional. Immutable. Designates the third party optimization partner that manages this algorithm. } diff --git a/googleapiclient/discovery_cache/documents/displayvideo.v4.json b/googleapiclient/discovery_cache/documents/displayvideo.v4.json index 59672a8d1b3..c6daee6d674 100644 --- a/googleapiclient/discovery_cache/documents/displayvideo.v4.json +++ b/googleapiclient/discovery_cache/documents/displayvideo.v4.json @@ -9302,7 +9302,7 @@ } } }, -"revision": "20250729", +"revision": "20250803", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -14079,6 +14079,20 @@ false "type": "string" }, "type": "array" +}, +"thirdPartyOptimizationPartner": { +"description": "Optional. Immutable. Designates the third party optimization partner that manages this algorithm.", +"enum": [ +"UNKNOWN", +"SCIBIDS", +"ADELAIDE" +], +"enumDescriptions": [ +"Type value is not specified or is unknown in this version.", +"Third party data science service provider that DV3 partners/advertisers can partner with.", +"Third party attention measurement service provider that DV3 partners/advertisers can partner with." +], +"type": "string" } }, "type": "object" From 47c9b877bdb79afcf736a15b5034bb5c8e93dda8 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:10:00 +0000 Subject: [PATCH 19/32] feat(file): update the api #### file:v1beta1 The following keys were added: - schemas.Instance.properties.backendType.type (Total Keys: 1) --- ..._v1beta1.projects.locations.instances.html | 4 ++++ .../discovery_cache/documents/file.v1.json | 8 ++++--- .../documents/file.v1beta1.json | 22 ++++++++++++++++--- 3 files changed, 28 insertions(+), 6 deletions(-) diff --git a/docs/dyn/file_v1beta1.projects.locations.instances.html b/docs/dyn/file_v1beta1.projects.locations.instances.html index ab3953861ec..1057b20283f 100644 --- a/docs/dyn/file_v1beta1.projects.locations.instances.html +++ b/docs/dyn/file_v1beta1.projects.locations.instances.html @@ -130,6 +130,7 @@

Method Details

The object takes the form of: { # A Filestore instance. + "backendType": "A String", # Optional. Immutable. Designates the backend type of this instance. Intended to be used by internal tests and allowed customers. "capacityGb": "A String", # The storage capacity of the instance in gigabytes (GB = 1024^3 bytes). This capacity can be increased up to `max_capacity_gb` GB in multipliers of `capacity_step_size_gb` GB. "capacityStepSizeGb": "A String", # Output only. The increase/decrease capacity step size. "createTime": "A String", # Output only. The time when the instance was created. @@ -322,6 +323,7 @@

Method Details

An object of the form: { # A Filestore instance. + "backendType": "A String", # Optional. Immutable. Designates the backend type of this instance. Intended to be used by internal tests and allowed customers. "capacityGb": "A String", # The storage capacity of the instance in gigabytes (GB = 1024^3 bytes). This capacity can be increased up to `max_capacity_gb` GB in multipliers of `capacity_step_size_gb` GB. "capacityStepSizeGb": "A String", # Output only. The increase/decrease capacity step size. "createTime": "A String", # Output only. The time when the instance was created. @@ -455,6 +457,7 @@

Method Details

{ # ListInstancesResponse is the result of ListInstancesRequest. "instances": [ # A list of instances in the project for the specified location. If the `{location}` value in the request is "-", the response contains a list of instances from all locations. If any location is unreachable, the response will only return instances in reachable locations and the "unreachable" field will be populated with a list of unreachable locations. { # A Filestore instance. + "backendType": "A String", # Optional. Immutable. Designates the backend type of this instance. Intended to be used by internal tests and allowed customers. "capacityGb": "A String", # The storage capacity of the instance in gigabytes (GB = 1024^3 bytes). This capacity can be increased up to `max_capacity_gb` GB in multipliers of `capacity_step_size_gb` GB. "capacityStepSizeGb": "A String", # Output only. The increase/decrease capacity step size. "createTime": "A String", # Output only. The time when the instance was created. @@ -597,6 +600,7 @@

Method Details

The object takes the form of: { # A Filestore instance. + "backendType": "A String", # Optional. Immutable. Designates the backend type of this instance. Intended to be used by internal tests and allowed customers. "capacityGb": "A String", # The storage capacity of the instance in gigabytes (GB = 1024^3 bytes). This capacity can be increased up to `max_capacity_gb` GB in multipliers of `capacity_step_size_gb` GB. "capacityStepSizeGb": "A String", # Output only. The increase/decrease capacity step size. "createTime": "A String", # Output only. The time when the instance was created. diff --git a/googleapiclient/discovery_cache/documents/file.v1.json b/googleapiclient/discovery_cache/documents/file.v1.json index 80c84f9106d..81a4974ac49 100644 --- a/googleapiclient/discovery_cache/documents/file.v1.json +++ b/googleapiclient/discovery_cache/documents/file.v1.json @@ -908,7 +908,7 @@ } } }, -"revision": "20250716", +"revision": "20250731", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -2114,14 +2114,16 @@ "CREATING", "READY", "REMOVING", -"FAILED" +"FAILED", +"PROMOTING" ], "enumDescriptions": [ "State not set.", "The replica is being created.", "The replica is ready.", "The replica is being removed.", -"The replica is experiencing an issue and might be unusable. You can get further details from the `stateReasons` field of the `ReplicaConfig` object." +"The replica is experiencing an issue and might be unusable. You can get further details from the `stateReasons` field of the `ReplicaConfig` object.", +"The replica is being promoted." ], "readOnly": true, "type": "string" diff --git a/googleapiclient/discovery_cache/documents/file.v1beta1.json b/googleapiclient/discovery_cache/documents/file.v1beta1.json index e17b7dccc0b..bf4312878ff 100644 --- a/googleapiclient/discovery_cache/documents/file.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/file.v1beta1.json @@ -1075,7 +1075,7 @@ } } }, -"revision": "20250716", +"revision": "20250731", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -1635,6 +1635,20 @@ "description": "A Filestore instance.", "id": "Instance", "properties": { +"backendType": { +"description": "Optional. Immutable. Designates the backend type of this instance. Intended to be used by internal tests and allowed customers.", +"enum": [ +"BACKEND_TYPE_UNSPECIFIED", +"COMPUTE_BASED_BACKEND", +"FILESTORE_BACKEND" +], +"enumDescriptions": [ +"Backend type not set.", +"Instance is backed by Compute.", +"Instance is backed by Filestore." +], +"type": "string" +}, "capacityGb": { "description": "The storage capacity of the instance in gigabytes (GB = 1024^3 bytes). This capacity can be increased up to `max_capacity_gb` GB in multipliers of `capacity_step_size_gb` GB.", "format": "int64", @@ -2433,14 +2447,16 @@ "CREATING", "READY", "REMOVING", -"FAILED" +"FAILED", +"PROMOTING" ], "enumDescriptions": [ "State not set.", "The replica is being created.", "The replica is ready.", "The replica is being removed.", -"The replica is experiencing an issue and might be unusable. You can get further details from the `stateReasons` field of the `ReplicaConfig` object." +"The replica is experiencing an issue and might be unusable. You can get further details from the `stateReasons` field of the `ReplicaConfig` object.", +"The replica is being promoted." ], "type": "string" }, From 570d7116d9e38f23825ff74a0b022a389e792eb2 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 12 Aug 2025 07:10:00 +0000 Subject: [PATCH 20/32] feat(firebaseappdistribution): update the api #### firebaseappdistribution:v1alpha The following keys were added: - schemas.GoogleFirebaseAppdistroV1alphaTestCase.properties.dependentTestCases (Total Keys: 3) - schemas.GoogleFirebaseAppdistroV1alphaTestCase.properties.prerequisiteTestCase.type (Total Keys: 1) --- .../dyn/firebaseappdistribution_v1.media.html | 2 +- ...rojects.apps.releases.feedbackReports.html | 4 +-- ...istribution_v1.projects.apps.releases.html | 14 ++++---- ...aseappdistribution_v1.projects.groups.html | 2 +- ...seappdistribution_v1.projects.testers.html | 2 +- .../firebaseappdistribution_v1alpha.apps.html | 2 +- ...ribution_v1alpha.apps.release_by_hash.html | 4 +-- ...appdistribution_v1alpha.apps.releases.html | 4 +-- ...tribution_v1alpha.apps.releases.notes.html | 4 +-- ...stribution_v1alpha.apps.upload_status.html | 4 +-- ...ution_v1alpha.projects.apps.testCases.html | 24 ++++++++++++++ .../documents/firebaseappdistribution.v1.json | 26 +++++++-------- .../firebaseappdistribution.v1alpha.json | 32 +++++++++++++------ 13 files changed, 80 insertions(+), 44 deletions(-) diff --git a/docs/dyn/firebaseappdistribution_v1.media.html b/docs/dyn/firebaseappdistribution_v1.media.html index 2c22fdb4ce4..8448374c828 100644 --- a/docs/dyn/firebaseappdistribution_v1.media.html +++ b/docs/dyn/firebaseappdistribution_v1.media.html @@ -91,7 +91,7 @@

Method Details

Uploads a binary. Uploading a binary can result in a new release being created, an update to an existing release, or a no-op if a release with the same binary already exists.
 
 Args:
-  app: string, The name of the app resource. Format: `projects/{project_number}/apps/{app_id}` (required)
+  app: string, Required. The name of the app resource. Format: `projects/{project_number}/apps/{app_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
diff --git a/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.feedbackReports.html b/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.feedbackReports.html
index 27e813adfc0..02e56a8c23b 100644
--- a/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.feedbackReports.html
+++ b/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.feedbackReports.html
@@ -143,8 +143,8 @@ 
Method Details

 
 Args:
   parent: string, Required. The name of the release resource, which is the parent of the feedback report resources. Format: `projects/{project_number}/apps/{app}/releases/{release}` (required)
-  pageSize: integer, The maximum number of feedback reports to return. The service may return fewer than this value. The valid range is [1-100]; If unspecified (0), at most 25 feedback reports are returned. Values above 100 are coerced to 100.
-  pageToken: string, A page token, received from a previous `ListFeedbackReports` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListFeedbackReports` must match the call that provided the page token.
+  pageSize: integer, Output only. The maximum number of feedback reports to return. The service may return fewer than this value. The valid range is [1-100]; If unspecified (0), at most 25 feedback reports are returned. Values above 100 are coerced to 100.
+  pageToken: string, Output only. A page token, received from a previous `ListFeedbackReports` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListFeedbackReports` must match the call that provided the page token.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.html b/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.html
index 6a2e2f13faf..26ea4f03646 100644
--- a/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.html
+++ b/docs/dyn/firebaseappdistribution_v1.projects.apps.releases.html
@@ -148,10 +148,10 @@ 
Method Details

     The object takes the form of:
 
 { # The request message for `DistributeRelease`.
-  "groupAliases": [ # A list of group aliases (IDs) to be given access to this release. A combined maximum of 999 `testerEmails` and `groupAliases` can be specified in a single request.
+  "groupAliases": [ # Optional. A list of group aliases (IDs) to be given access to this release. A combined maximum of 999 `testerEmails` and `groupAliases` can be specified in a single request.
     "A String",
   ],
-  "testerEmails": [ # A list of tester email addresses to be given access to this release. A combined maximum of 999 `testerEmails` and `groupAliases` can be specified in a single request.
+  "testerEmails": [ # Optional. A list of tester email addresses to be given access to this release. A combined maximum of 999 `testerEmails` and `groupAliases` can be specified in a single request.
     "A String",
   ],
 }
@@ -202,10 +202,10 @@ 
Method Details

 
 Args:
   parent: string, Required. The name of the app resource, which is the parent of the release resources. Format: `projects/{project_number}/apps/{app_id}` (required)
-  filter: string, The expression to filter releases listed in the response. To learn more about filtering, refer to [Google's AIP-160 standard](http://aip.dev/160). Supported fields: - `releaseNotes.text` supports `=` (can contain a wildcard character (`*`) at the beginning or end of the string) - `createTime` supports `<`, `<=`, `>` and `>=`, and expects an RFC-3339 formatted string Examples: - `createTime <= "2021-09-08T00:00:00+04:00"` - `releaseNotes.text="fixes" AND createTime >= "2021-09-08T00:00:00.0Z"` - `releaseNotes.text="*v1.0.0-rc*"`
-  orderBy: string, The fields used to order releases. Supported fields: - `createTime` To specify descending order for a field, append a "desc" suffix, for example, `createTime desc`. If this parameter is not set, releases are ordered by `createTime` in descending order.
-  pageSize: integer, The maximum number of releases to return. The service may return fewer than this value. The valid range is [1-100]; If unspecified (0), at most 25 releases are returned. Values above 100 are coerced to 100.
-  pageToken: string, A page token, received from a previous `ListReleases` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReleases` must match the call that provided the page token.
+  filter: string, Optional. The expression to filter releases listed in the response. To learn more about filtering, refer to [Google's AIP-160 standard](http://aip.dev/160). Supported fields: - `releaseNotes.text` supports `=` (can contain a wildcard character (`*`) at the beginning or end of the string) - `createTime` supports `<`, `<=`, `>` and `>=`, and expects an RFC-3339 formatted string Examples: - `createTime <= "2021-09-08T00:00:00+04:00"` - `releaseNotes.text="fixes" AND createTime >= "2021-09-08T00:00:00.0Z"` - `releaseNotes.text="*v1.0.0-rc*"`
+  orderBy: string, Optional. The fields used to order releases. Supported fields: - `createTime` To specify descending order for a field, append a "desc" suffix, for example, `createTime desc`. If this parameter is not set, releases are ordered by `createTime` in descending order.
+  pageSize: integer, Optional. The maximum number of releases to return. The service may return fewer than this value. The valid range is [1-100]; If unspecified (0), at most 25 releases are returned. Values above 100 are coerced to 100.
+  pageToken: string, Optional. A page token, received from a previous `ListReleases` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReleases` must match the call that provided the page token.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -269,7 +269,7 @@ 
Method Details

   "testingUri": "A String", # Output only. A link to the release in the tester web clip or Android app that lets testers (which were granted access to the app) view release notes and install the app onto their devices.
 }
 
-  updateMask: string, The list of fields to update.
+  updateMask: string, Optional. The list of fields to update.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/firebaseappdistribution_v1.projects.groups.html b/docs/dyn/firebaseappdistribution_v1.projects.groups.html
index a03b6058a4c..831db39d8ea 100644
--- a/docs/dyn/firebaseappdistribution_v1.projects.groups.html
+++ b/docs/dyn/firebaseappdistribution_v1.projects.groups.html
@@ -299,7 +299,7 @@ 
Method Details

   "testerCount": 42, # Output only. The number of testers who are members of this group.
 }
 
-  updateMask: string, The list of fields to update.
+  updateMask: string, Optional. The list of fields to update.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/firebaseappdistribution_v1.projects.testers.html b/docs/dyn/firebaseappdistribution_v1.projects.testers.html
index 74f12e4d16c..2c26da1701d 100644
--- a/docs/dyn/firebaseappdistribution_v1.projects.testers.html
+++ b/docs/dyn/firebaseappdistribution_v1.projects.testers.html
@@ -229,7 +229,7 @@ 
Method Details

   "name": "A String", # The name of the tester resource. Format: `projects/{project_number}/testers/{email_address}`
 }
 
-  updateMask: string, The list of fields to update.
+  updateMask: string, Optional. The list of fields to update.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/firebaseappdistribution_v1alpha.apps.html b/docs/dyn/firebaseappdistribution_v1alpha.apps.html
index 455d8e27454..644c2f36784 100644
--- a/docs/dyn/firebaseappdistribution_v1alpha.apps.html
+++ b/docs/dyn/firebaseappdistribution_v1alpha.apps.html
@@ -148,7 +148,7 @@ 
Method Details

   
Get a JWT token
 
 Args:
-  mobilesdkAppId: string, Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289 (required)
+  mobilesdkAppId: string, Required. Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289 (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/firebaseappdistribution_v1alpha.apps.release_by_hash.html b/docs/dyn/firebaseappdistribution_v1alpha.apps.release_by_hash.html
index 30154476b81..c0f9d5522fa 100644
--- a/docs/dyn/firebaseappdistribution_v1alpha.apps.release_by_hash.html
+++ b/docs/dyn/firebaseappdistribution_v1alpha.apps.release_by_hash.html
@@ -91,8 +91,8 @@ 
Method Details

   
GET Release by binary upload hash
 
 Args:
-  mobilesdkAppId: string, Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289 (required)
-  uploadHash: string, The hash for the upload (required)
+  mobilesdkAppId: string, Required. Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289 (required)
+  uploadHash: string, Required. The hash for the upload (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/firebaseappdistribution_v1alpha.apps.releases.html b/docs/dyn/firebaseappdistribution_v1alpha.apps.releases.html
index 6dea6bb21a2..db99c9c6005 100644
--- a/docs/dyn/firebaseappdistribution_v1alpha.apps.releases.html
+++ b/docs/dyn/firebaseappdistribution_v1alpha.apps.releases.html
@@ -96,8 +96,8 @@ 
Method Details

   
Enable access on a release for testers.
 
 Args:
-  mobilesdkAppId: string, Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289 (required)
-  releaseId: string, Release identifier (required)
+  mobilesdkAppId: string, Required. Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289 (required)
+  releaseId: string, Required. Release identifier (required)
   body: object, The request body.
     The object takes the form of:
 
diff --git a/docs/dyn/firebaseappdistribution_v1alpha.apps.releases.notes.html b/docs/dyn/firebaseappdistribution_v1alpha.apps.releases.notes.html
index 13bc891e6a3..a607ded64c1 100644
--- a/docs/dyn/firebaseappdistribution_v1alpha.apps.releases.notes.html
+++ b/docs/dyn/firebaseappdistribution_v1alpha.apps.releases.notes.html
@@ -91,8 +91,8 @@ 
Method Details

   
Create release notes on a release.
 
 Args:
-  mobilesdkAppId: string, Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289 (required)
-  releaseId: string, Release identifier (required)
+  mobilesdkAppId: string, Required. Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289 (required)
+  releaseId: string, Required. Release identifier (required)
   body: object, The request body.
     The object takes the form of:
 
diff --git a/docs/dyn/firebaseappdistribution_v1alpha.apps.upload_status.html b/docs/dyn/firebaseappdistribution_v1alpha.apps.upload_status.html
index 85be523a584..b2bd3a8a827 100644
--- a/docs/dyn/firebaseappdistribution_v1alpha.apps.upload_status.html
+++ b/docs/dyn/firebaseappdistribution_v1alpha.apps.upload_status.html
@@ -91,8 +91,8 @@ 
Method Details

   
GET Binary upload status by token
 
 Args:
-  mobilesdkAppId: string, Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289 (required)
-  uploadToken: string, The token for the upload (required)
+  mobilesdkAppId: string, Required. Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289 (required)
+  uploadToken: string, Required. The token for the upload (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/firebaseappdistribution_v1alpha.projects.apps.testCases.html b/docs/dyn/firebaseappdistribution_v1alpha.projects.apps.testCases.html
index ae36085374c..93736fcd7d7 100644
--- a/docs/dyn/firebaseappdistribution_v1alpha.projects.apps.testCases.html
+++ b/docs/dyn/firebaseappdistribution_v1alpha.projects.apps.testCases.html
@@ -152,8 +152,12 @@ 
Method Details

     ],
   },
   "createTime": "A String", # Output only. Timestamp when the test case was created
+  "dependentTestCases": [ # Output only. Other test cases that depend on this test cse as a prerequisite.
+    "A String",
+  ],
   "displayName": "A String", # Required. Display name of the test case.
   "name": "A String", # Identifier. The name of the test case resource. Format: `projects/{project_number}/apps/{app_id}/testCases/{test_case_id}`
+  "prerequisiteTestCase": "A String", # Optional. Test case that must be run before this test case.
 }
 
   testCaseId: string, Optional. The ID to use for the test case, which will become the final component of the test case's resource name. This value should be 4-63 characters, and valid characters are /a-z-/.
@@ -177,8 +181,12 @@ 
Method Details

     ],
   },
   "createTime": "A String", # Output only. Timestamp when the test case was created
+  "dependentTestCases": [ # Output only. Other test cases that depend on this test cse as a prerequisite.
+    "A String",
+  ],
   "displayName": "A String", # Required. Display name of the test case.
   "name": "A String", # Identifier. The name of the test case resource. Format: `projects/{project_number}/apps/{app_id}/testCases/{test_case_id}`
+  "prerequisiteTestCase": "A String", # Optional. Test case that must be run before this test case.
 }

 
 
@@ -226,8 +234,12 @@ 
Method Details

     ],
   },
   "createTime": "A String", # Output only. Timestamp when the test case was created
+  "dependentTestCases": [ # Output only. Other test cases that depend on this test cse as a prerequisite.
+    "A String",
+  ],
   "displayName": "A String", # Required. Display name of the test case.
   "name": "A String", # Identifier. The name of the test case resource. Format: `projects/{project_number}/apps/{app_id}/testCases/{test_case_id}`
+  "prerequisiteTestCase": "A String", # Optional. Test case that must be run before this test case.
 }

 
 
@@ -262,8 +274,12 @@ 
Method Details

         ],
       },
       "createTime": "A String", # Output only. Timestamp when the test case was created
+      "dependentTestCases": [ # Output only. Other test cases that depend on this test cse as a prerequisite.
+        "A String",
+      ],
       "displayName": "A String", # Required. Display name of the test case.
       "name": "A String", # Identifier. The name of the test case resource. Format: `projects/{project_number}/apps/{app_id}/testCases/{test_case_id}`
+      "prerequisiteTestCase": "A String", # Optional. Test case that must be run before this test case.
     },
   ],
 }

@@ -304,8 +320,12 @@ 
Method Details

     ],
   },
   "createTime": "A String", # Output only. Timestamp when the test case was created
+  "dependentTestCases": [ # Output only. Other test cases that depend on this test cse as a prerequisite.
+    "A String",
+  ],
   "displayName": "A String", # Required. Display name of the test case.
   "name": "A String", # Identifier. The name of the test case resource. Format: `projects/{project_number}/apps/{app_id}/testCases/{test_case_id}`
+  "prerequisiteTestCase": "A String", # Optional. Test case that must be run before this test case.
 }
 
   x__xgafv: string, V1 error format.
@@ -328,8 +348,12 @@ 
Method Details

     ],
   },
   "createTime": "A String", # Output only. Timestamp when the test case was created
+  "dependentTestCases": [ # Output only. Other test cases that depend on this test cse as a prerequisite.
+    "A String",
+  ],
   "displayName": "A String", # Required. Display name of the test case.
   "name": "A String", # Identifier. The name of the test case resource. Format: `projects/{project_number}/apps/{app_id}/testCases/{test_case_id}`
+  "prerequisiteTestCase": "A String", # Optional. Test case that must be run before this test case.
 }

 
 
diff --git a/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1.json b/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1.json
index 6bcc48196a0..9aa065f97dd 100644
--- a/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1.json
+++ b/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1.json
@@ -128,7 +128,7 @@
 ],
 "parameters": {
 "app": {
-"description": "The name of the app resource. Format: `projects/{project_number}/apps/{app_id}`",
+"description": "Required. The name of the app resource. Format: `projects/{project_number}/apps/{app_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/apps/[^/]+$",
 "required": true,
@@ -273,23 +273,23 @@
 ],
 "parameters": {
 "filter": {
-"description": "The expression to filter releases listed in the response. To learn more about filtering, refer to [Google's AIP-160 standard](http://aip.dev/160). Supported fields: - `releaseNotes.text` supports `=` (can contain a wildcard character (`*`) at the beginning or end of the string) - `createTime` supports `<`, `<=`, `>` and `>=`, and expects an RFC-3339 formatted string Examples: - `createTime <= \"2021-09-08T00:00:00+04:00\"` - `releaseNotes.text=\"fixes\" AND createTime >= \"2021-09-08T00:00:00.0Z\"` - `releaseNotes.text=\"*v1.0.0-rc*\"`",
+"description": "Optional. The expression to filter releases listed in the response. To learn more about filtering, refer to [Google's AIP-160 standard](http://aip.dev/160). Supported fields: - `releaseNotes.text` supports `=` (can contain a wildcard character (`*`) at the beginning or end of the string) - `createTime` supports `<`, `<=`, `>` and `>=`, and expects an RFC-3339 formatted string Examples: - `createTime <= \"2021-09-08T00:00:00+04:00\"` - `releaseNotes.text=\"fixes\" AND createTime >= \"2021-09-08T00:00:00.0Z\"` - `releaseNotes.text=\"*v1.0.0-rc*\"`",
 "location": "query",
 "type": "string"
 },
 "orderBy": {
-"description": "The fields used to order releases. Supported fields: - `createTime` To specify descending order for a field, append a \"desc\" suffix, for example, `createTime desc`. If this parameter is not set, releases are ordered by `createTime` in descending order.",
+"description": "Optional. The fields used to order releases. Supported fields: - `createTime` To specify descending order for a field, append a \"desc\" suffix, for example, `createTime desc`. If this parameter is not set, releases are ordered by `createTime` in descending order.",
 "location": "query",
 "type": "string"
 },
 "pageSize": {
-"description": "The maximum number of releases to return. The service may return fewer than this value. The valid range is [1-100]; If unspecified (0), at most 25 releases are returned. Values above 100 are coerced to 100.",
+"description": "Optional. The maximum number of releases to return. The service may return fewer than this value. The valid range is [1-100]; If unspecified (0), at most 25 releases are returned. Values above 100 are coerced to 100.",
 "format": "int32",
 "location": "query",
 "type": "integer"
 },
 "pageToken": {
-"description": "A page token, received from a previous `ListReleases` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReleases` must match the call that provided the page token.",
+"description": "Optional. A page token, received from a previous `ListReleases` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReleases` must match the call that provided the page token.",
 "location": "query",
 "type": "string"
 },
@@ -326,7 +326,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "The list of fields to update.",
+"description": "Optional. The list of fields to update.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -407,13 +407,13 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "The maximum number of feedback reports to return. The service may return fewer than this value. The valid range is [1-100]; If unspecified (0), at most 25 feedback reports are returned. Values above 100 are coerced to 100.",
+"description": "Output only. The maximum number of feedback reports to return. The service may return fewer than this value. The valid range is [1-100]; If unspecified (0), at most 25 feedback reports are returned. Values above 100 are coerced to 100.",
 "format": "int32",
 "location": "query",
 "type": "integer"
 },
 "pageToken": {
-"description": "A page token, received from a previous `ListFeedbackReports` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListFeedbackReports` must match the call that provided the page token.",
+"description": "Output only. A page token, received from a previous `ListFeedbackReports` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListFeedbackReports` must match the call that provided the page token.",
 "location": "query",
 "type": "string"
 },
@@ -784,7 +784,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "The list of fields to update.",
+"description": "Optional. The list of fields to update.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -919,7 +919,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "The list of fields to update.",
+"description": "Optional. The list of fields to update.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -941,7 +941,7 @@
 }
 }
 },
-"revision": "20241115",
+"revision": "20250808",
 "rootUrl": "https://firebaseappdistribution.googleapis.com/",
 "schemas": {
 "GdataBlobstore2Info": {
@@ -1518,14 +1518,14 @@
 "id": "GoogleFirebaseAppdistroV1DistributeReleaseRequest",
 "properties": {
 "groupAliases": {
-"description": "A list of group aliases (IDs) to be given access to this release. A combined maximum of 999 `testerEmails` and `groupAliases` can be specified in a single request.",
+"description": "Optional. A list of group aliases (IDs) to be given access to this release. A combined maximum of 999 `testerEmails` and `groupAliases` can be specified in a single request.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "testerEmails": {
-"description": "A list of tester email addresses to be given access to this release. A combined maximum of 999 `testerEmails` and `groupAliases` can be specified in a single request.",
+"description": "Optional. A list of tester email addresses to be given access to this release. A combined maximum of 999 `testerEmails` and `groupAliases` can be specified in a single request.",
 "items": {
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1alpha.json b/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1alpha.json
index 066f84f07f8..4d159f810d3 100644
--- a/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1alpha.json
@@ -156,7 +156,7 @@
 ],
 "parameters": {
 "mobilesdkAppId": {
-"description": "Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289",
+"description": "Required. Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289",
 "location": "path",
 "required": true,
 "type": "string"
@@ -185,13 +185,13 @@
 ],
 "parameters": {
 "mobilesdkAppId": {
-"description": "Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289",
+"description": "Required. Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "uploadHash": {
-"description": "The hash for the upload",
+"description": "Required. The hash for the upload",
 "location": "path",
 "required": true,
 "type": "string"
@@ -220,13 +220,13 @@
 ],
 "parameters": {
 "mobilesdkAppId": {
-"description": "Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289",
+"description": "Required. Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "releaseId": {
-"description": "Release identifier",
+"description": "Required. Release identifier",
 "location": "path",
 "required": true,
 "type": "string"
@@ -258,13 +258,13 @@
 ],
 "parameters": {
 "mobilesdkAppId": {
-"description": "Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289",
+"description": "Required. Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "releaseId": {
-"description": "Release identifier",
+"description": "Required. Release identifier",
 "location": "path",
 "required": true,
 "type": "string"
@@ -331,13 +331,13 @@
 ],
 "parameters": {
 "mobilesdkAppId": {
-"description": "Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289",
+"description": "Required. Unique id for a Firebase app of the format: {version}:{project_number}:{platform}:{hash(bundle_id)} Example: 1:581234567376:android:aa0a3c7b135e90289",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "uploadToken": {
-"description": "The token for the upload",
+"description": "Required. The token for the upload",
 "location": "path",
 "required": true,
 "type": "string"
@@ -807,7 +807,7 @@
 }
 }
 },
-"revision": "20250612",
+"revision": "20250808",
 "rootUrl": "https://firebaseappdistribution.googleapis.com/",
 "schemas": {
 "AndroidxCrawlerOutputPoint": {
@@ -1927,6 +1927,14 @@
 "readOnly": true,
 "type": "string"
 },
+"dependentTestCases": {
+"description": "Output only. Other test cases that depend on this test cse as a prerequisite.",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
 "displayName": {
 "description": "Required. Display name of the test case.",
 "type": "string"
@@ -1934,6 +1942,10 @@
 "name": {
 "description": "Identifier. The name of the test case resource. Format: `projects/{project_number}/apps/{app_id}/testCases/{test_case_id}`",
 "type": "string"
+},
+"prerequisiteTestCase": {
+"description": "Optional. Test case that must be run before this test case.",
+"type": "string"
 }
 },
 "type": "object"

From 632f86fba1d7519abfc33e0b23b7f0d84d166fdf Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:00 +0000
Subject: [PATCH 21/32] feat(firebasedataconnect): update the api

#### firebasedataconnect:v1

The following keys were added:
- schemas.PostgreSql.properties.ephemeral (Total Keys: 2)
- schemas.PostgreSql.properties.unlinked.deprecated (Total Keys: 1)

#### firebasedataconnect:v1beta

The following keys were added:
- schemas.PostgreSql.properties.ephemeral (Total Keys: 2)
- schemas.PostgreSql.properties.unlinked.deprecated (Total Keys: 1)
---
 ...ataconnect_v1.projects.locations.services.schemas.html | 4 ++++
 ...onnect_v1beta.projects.locations.services.schemas.html | 4 ++++
 .../discovery_cache/documents/firebasedataconnect.v1.json | 8 +++++++-
 .../documents/firebasedataconnect.v1beta.json             | 8 +++++++-
 4 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/docs/dyn/firebasedataconnect_v1.projects.locations.services.schemas.html b/docs/dyn/firebasedataconnect_v1.projects.locations.services.schemas.html
index 7764d44a6e3..c2611ade9a8 100644
--- a/docs/dyn/firebasedataconnect_v1.projects.locations.services.schemas.html
+++ b/docs/dyn/firebasedataconnect_v1.projects.locations.services.schemas.html
@@ -122,6 +122,7 @@ 
Method Details

           "instance": "A String", # Required. Name of the CloudSQL instance, in the format: ``` projects/{project}/locations/{location}/instances/{instance} ```
         },
         "database": "A String", # Required. Name of the PostgreSQL database.
+        "ephemeral": True or False, # Output only. Ephemeral is true if this data connect service is served from in-memory emulation of Postgres. Data Connect service will transfer the data on a best-effort basis to the Cloud SQL instance once it's provisioned and linked. WARNING: When `ephemeral=true`, mutations to the database are not guaranteed to be durably persisted, even if an OK status code is returned. All or parts of the data may be lost or reverted to earlier versions.
         "schemaMigration": "A String", # Optional. Configure how to perform Postgresql schema migration.
         "schemaValidation": "A String", # Optional. Configure how much Postgresql schema validation to perform.
         "unlinked": True or False, # No Postgres data source is linked. If set, don't allow `database` and `schema_validation` to be configured.
@@ -245,6 +246,7 @@ 
Method Details

           "instance": "A String", # Required. Name of the CloudSQL instance, in the format: ``` projects/{project}/locations/{location}/instances/{instance} ```
         },
         "database": "A String", # Required. Name of the PostgreSQL database.
+        "ephemeral": True or False, # Output only. Ephemeral is true if this data connect service is served from in-memory emulation of Postgres. Data Connect service will transfer the data on a best-effort basis to the Cloud SQL instance once it's provisioned and linked. WARNING: When `ephemeral=true`, mutations to the database are not guaranteed to be durably persisted, even if an OK status code is returned. All or parts of the data may be lost or reverted to earlier versions.
         "schemaMigration": "A String", # Optional. Configure how to perform Postgresql schema migration.
         "schemaValidation": "A String", # Optional. Configure how much Postgresql schema validation to perform.
         "unlinked": True or False, # No Postgres data source is linked. If set, don't allow `database` and `schema_validation` to be configured.
@@ -304,6 +306,7 @@ 
Method Details

               "instance": "A String", # Required. Name of the CloudSQL instance, in the format: ``` projects/{project}/locations/{location}/instances/{instance} ```
             },
             "database": "A String", # Required. Name of the PostgreSQL database.
+            "ephemeral": True or False, # Output only. Ephemeral is true if this data connect service is served from in-memory emulation of Postgres. Data Connect service will transfer the data on a best-effort basis to the Cloud SQL instance once it's provisioned and linked. WARNING: When `ephemeral=true`, mutations to the database are not guaranteed to be durably persisted, even if an OK status code is returned. All or parts of the data may be lost or reverted to earlier versions.
             "schemaMigration": "A String", # Optional. Configure how to perform Postgresql schema migration.
             "schemaValidation": "A String", # Optional. Configure how much Postgresql schema validation to perform.
             "unlinked": True or False, # No Postgres data source is linked. If set, don't allow `database` and `schema_validation` to be configured.
@@ -370,6 +373,7 @@ 
Method Details

           "instance": "A String", # Required. Name of the CloudSQL instance, in the format: ``` projects/{project}/locations/{location}/instances/{instance} ```
         },
         "database": "A String", # Required. Name of the PostgreSQL database.
+        "ephemeral": True or False, # Output only. Ephemeral is true if this data connect service is served from in-memory emulation of Postgres. Data Connect service will transfer the data on a best-effort basis to the Cloud SQL instance once it's provisioned and linked. WARNING: When `ephemeral=true`, mutations to the database are not guaranteed to be durably persisted, even if an OK status code is returned. All or parts of the data may be lost or reverted to earlier versions.
         "schemaMigration": "A String", # Optional. Configure how to perform Postgresql schema migration.
         "schemaValidation": "A String", # Optional. Configure how much Postgresql schema validation to perform.
         "unlinked": True or False, # No Postgres data source is linked. If set, don't allow `database` and `schema_validation` to be configured.
diff --git a/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.schemas.html b/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.schemas.html
index 245300935a3..7be6c829bc9 100644
--- a/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.schemas.html
+++ b/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.schemas.html
@@ -122,6 +122,7 @@ 
Method Details

           "instance": "A String", # Required. Name of the CloudSQL instance, in the format: ``` projects/{project}/locations/{location}/instances/{instance} ```
         },
         "database": "A String", # Required. Name of the PostgreSQL database.
+        "ephemeral": True or False, # Output only. Ephemeral is true if this data connect service is served from in-memory emulation of Postgres. Data Connect service will transfer the data on a best-effort basis to the Cloud SQL instance once it's provisioned and linked. WARNING: When `ephemeral=true`, mutations to the database are not guaranteed to be durably persisted, even if an OK status code is returned. All or parts of the data may be lost or reverted to earlier versions.
         "schemaMigration": "A String", # Optional. Configure how to perform Postgresql schema migration.
         "schemaValidation": "A String", # Optional. Configure how much Postgresql schema validation to perform.
         "unlinked": True or False, # No Postgres data source is linked. If set, don't allow `database` and `schema_validation` to be configured.
@@ -245,6 +246,7 @@ 
Method Details

           "instance": "A String", # Required. Name of the CloudSQL instance, in the format: ``` projects/{project}/locations/{location}/instances/{instance} ```
         },
         "database": "A String", # Required. Name of the PostgreSQL database.
+        "ephemeral": True or False, # Output only. Ephemeral is true if this data connect service is served from in-memory emulation of Postgres. Data Connect service will transfer the data on a best-effort basis to the Cloud SQL instance once it's provisioned and linked. WARNING: When `ephemeral=true`, mutations to the database are not guaranteed to be durably persisted, even if an OK status code is returned. All or parts of the data may be lost or reverted to earlier versions.
         "schemaMigration": "A String", # Optional. Configure how to perform Postgresql schema migration.
         "schemaValidation": "A String", # Optional. Configure how much Postgresql schema validation to perform.
         "unlinked": True or False, # No Postgres data source is linked. If set, don't allow `database` and `schema_validation` to be configured.
@@ -304,6 +306,7 @@ 
Method Details

               "instance": "A String", # Required. Name of the CloudSQL instance, in the format: ``` projects/{project}/locations/{location}/instances/{instance} ```
             },
             "database": "A String", # Required. Name of the PostgreSQL database.
+            "ephemeral": True or False, # Output only. Ephemeral is true if this data connect service is served from in-memory emulation of Postgres. Data Connect service will transfer the data on a best-effort basis to the Cloud SQL instance once it's provisioned and linked. WARNING: When `ephemeral=true`, mutations to the database are not guaranteed to be durably persisted, even if an OK status code is returned. All or parts of the data may be lost or reverted to earlier versions.
             "schemaMigration": "A String", # Optional. Configure how to perform Postgresql schema migration.
             "schemaValidation": "A String", # Optional. Configure how much Postgresql schema validation to perform.
             "unlinked": True or False, # No Postgres data source is linked. If set, don't allow `database` and `schema_validation` to be configured.
@@ -370,6 +373,7 @@ 
Method Details

           "instance": "A String", # Required. Name of the CloudSQL instance, in the format: ``` projects/{project}/locations/{location}/instances/{instance} ```
         },
         "database": "A String", # Required. Name of the PostgreSQL database.
+        "ephemeral": True or False, # Output only. Ephemeral is true if this data connect service is served from in-memory emulation of Postgres. Data Connect service will transfer the data on a best-effort basis to the Cloud SQL instance once it's provisioned and linked. WARNING: When `ephemeral=true`, mutations to the database are not guaranteed to be durably persisted, even if an OK status code is returned. All or parts of the data may be lost or reverted to earlier versions.
         "schemaMigration": "A String", # Optional. Configure how to perform Postgresql schema migration.
         "schemaValidation": "A String", # Optional. Configure how much Postgresql schema validation to perform.
         "unlinked": True or False, # No Postgres data source is linked. If set, don't allow `database` and `schema_validation` to be configured.
diff --git a/googleapiclient/discovery_cache/documents/firebasedataconnect.v1.json b/googleapiclient/discovery_cache/documents/firebasedataconnect.v1.json
index 981d975470f..84462760736 100644
--- a/googleapiclient/discovery_cache/documents/firebasedataconnect.v1.json
+++ b/googleapiclient/discovery_cache/documents/firebasedataconnect.v1.json
@@ -1076,7 +1076,7 @@
 }
 }
 },
-"revision": "20250706",
+"revision": "20250803",
 "rootUrl": "https://firebasedataconnect.googleapis.com/",
 "schemas": {
 "CancelOperationRequest": {
@@ -1679,6 +1679,11 @@
 "description": "Required. Name of the PostgreSQL database.",
 "type": "string"
 },
+"ephemeral": {
+"description": "Output only. Ephemeral is true if this data connect service is served from in-memory emulation of Postgres. Data Connect service will transfer the data on a best-effort basis to the Cloud SQL instance once it's provisioned and linked. WARNING: When `ephemeral=true`, mutations to the database are not guaranteed to be durably persisted, even if an OK status code is returned. All or parts of the data may be lost or reverted to earlier versions.",
+"readOnly": true,
+"type": "boolean"
+},
 "schemaMigration": {
 "description": "Optional. Configure how to perform Postgresql schema migration.",
 "enum": [
@@ -1708,6 +1713,7 @@
 "type": "string"
 },
 "unlinked": {
+"deprecated": true,
 "description": "No Postgres data source is linked. If set, don't allow `database` and `schema_validation` to be configured.",
 "type": "boolean"
 }
diff --git a/googleapiclient/discovery_cache/documents/firebasedataconnect.v1beta.json b/googleapiclient/discovery_cache/documents/firebasedataconnect.v1beta.json
index 06d3d6e56c6..5a1797d1f41 100644
--- a/googleapiclient/discovery_cache/documents/firebasedataconnect.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/firebasedataconnect.v1beta.json
@@ -1076,7 +1076,7 @@
 }
 }
 },
-"revision": "20250706",
+"revision": "20250803",
 "rootUrl": "https://firebasedataconnect.googleapis.com/",
 "schemas": {
 "CancelOperationRequest": {
@@ -1679,6 +1679,11 @@
 "description": "Required. Name of the PostgreSQL database.",
 "type": "string"
 },
+"ephemeral": {
+"description": "Output only. Ephemeral is true if this data connect service is served from in-memory emulation of Postgres. Data Connect service will transfer the data on a best-effort basis to the Cloud SQL instance once it's provisioned and linked. WARNING: When `ephemeral=true`, mutations to the database are not guaranteed to be durably persisted, even if an OK status code is returned. All or parts of the data may be lost or reverted to earlier versions.",
+"readOnly": true,
+"type": "boolean"
+},
 "schemaMigration": {
 "description": "Optional. Configure how to perform Postgresql schema migration.",
 "enum": [
@@ -1708,6 +1713,7 @@
 "type": "string"
 },
 "unlinked": {
+"deprecated": true,
 "description": "No Postgres data source is linked. If set, don't allow `database` and `schema_validation` to be configured.",
 "type": "boolean"
 }

From 8d7c87f29071bb56efd818b53b8233c36371d3bd Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:00 +0000
Subject: [PATCH 22/32] feat(firebaseml): update the api

#### firebaseml:v2beta

The following keys were added:
- schemas.GoogleCloudAiplatformV1beta1GenerateContentRequest.properties.modelArmorConfig.$ref (Total Keys: 1)
- schemas.GoogleCloudAiplatformV1beta1ModelArmorConfig (Total Keys: 4)
---
 ....projects.locations.publishers.models.html |  8 ++++++
 .../documents/firebaseml.v2beta.json          | 25 ++++++++++++++++++-
 2 files changed, 32 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html b/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
index eedc94372fa..132c7225084 100644
--- a/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
+++ b/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
@@ -688,6 +688,10 @@ 
Method Details

   "labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.
     "a_key": "A String",
   },
+  "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied.
+    "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization.
+    "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization.
+  },
   "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.
     { # Safety settings.
       "category": "A String", # Required. Harm category.
@@ -1386,6 +1390,10 @@ 
Method Details

   "labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.
     "a_key": "A String",
   },
+  "modelArmorConfig": { # Configuration for Model Armor integrations of prompt and responses. # Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied.
+    "promptTemplateName": "A String", # Optional. The name of the Model Armor template to use for prompt sanitization.
+    "responseTemplateName": "A String", # Optional. The name of the Model Armor template to use for response sanitization.
+  },
   "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.
     { # Safety settings.
       "category": "A String", # Required. Harm category.
diff --git a/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json b/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
index ed3911572a8..b2257c0b562 100644
--- a/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
@@ -206,7 +206,7 @@
 }
 }
 },
-"revision": "20250727",
+"revision": "20250731",
 "rootUrl": "https://firebaseml.googleapis.com/",
 "schemas": {
 "Date": {
@@ -455,6 +455,7 @@
 "PROHIBITED_CONTENT",
 "SPII",
 "MALFORMED_FUNCTION_CALL",
+"MODEL_ARMOR",
 "IMAGE_SAFETY",
 "IMAGE_PROHIBITED_CONTENT",
 "IMAGE_RECITATION",
@@ -472,6 +473,7 @@
 "Token generation stopped for potentially containing prohibited content.",
 "Token generation stopped because the content potentially contains Sensitive Personally Identifiable Information (SPII).",
 "The function call generated by the model is invalid.",
+"The model response was blocked by Model Armor.",
 "Token generation stopped because generated images has safety violations.",
 "Image generation stopped because generated images has other prohibited content.",
 "Image generation stopped due to recitation.",
@@ -958,6 +960,10 @@
 "description": "Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.",
 "type": "object"
 },
+"modelArmorConfig": {
+"$ref": "GoogleCloudAiplatformV1beta1ModelArmorConfig",
+"description": "Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied."
+},
 "safetySettings": {
 "description": "Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.",
 "items": {
@@ -1035,6 +1041,7 @@
 "OTHER",
 "BLOCKLIST",
 "PROHIBITED_CONTENT",
+"MODEL_ARMOR",
 "IMAGE_SAFETY"
 ],
 "enumDescriptions": [
@@ -1043,6 +1050,7 @@
 "Candidates blocked due to other reason.",
 "Candidates blocked due to the terms which are included from the terminology blocklist.",
 "Candidates blocked due to prohibited content.",
+"The user prompt was blocked by Model Armor.",
 "Candidates blocked due to unsafe image generation content."
 ],
 "readOnly": true,
@@ -1716,6 +1724,21 @@
 },
 "type": "object"
 },
+"GoogleCloudAiplatformV1beta1ModelArmorConfig": {
+"description": "Configuration for Model Armor integrations of prompt and responses.",
+"id": "GoogleCloudAiplatformV1beta1ModelArmorConfig",
+"properties": {
+"promptTemplateName": {
+"description": "Optional. The name of the Model Armor template to use for prompt sanitization.",
+"type": "string"
+},
+"responseTemplateName": {
+"description": "Optional. The name of the Model Armor template to use for response sanitization.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudAiplatformV1beta1Part": {
 "description": "A datatype containing media that is part of a multi-part `Content` message. A `Part` consists of data which has an associated datatype. A `Part` can only contain one of the accepted types in `Part.data`. A `Part` must have a fixed IANA MIME type identifying the type and subtype of the media if `inline_data` or `file_data` field is filled with raw bytes.",
 "id": "GoogleCloudAiplatformV1beta1Part",

From 8ea30b6c4e40495b05eb39933a25092542ce4504 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:00 +0000
Subject: [PATCH 23/32] feat(managedkafka): update the api

#### managedkafka:v1

The following keys were added:
- resources.projects.resources.locations.resources.schemaRegistries.methods.list.parameters.view (Total Keys: 2)
---
 ..._v1.projects.locations.schemaRegistries.html |  9 +++++++--
 .../documents/managedkafka.v1.json              | 17 ++++++++++++++++-
 2 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/docs/dyn/managedkafka_v1.projects.locations.schemaRegistries.html b/docs/dyn/managedkafka_v1.projects.locations.schemaRegistries.html
index 782d1579c6b..c2278e58210 100644
--- a/docs/dyn/managedkafka_v1.projects.locations.schemaRegistries.html
+++ b/docs/dyn/managedkafka_v1.projects.locations.schemaRegistries.html
@@ -117,7 +117,7 @@ 
Instance Methods

   get(name, x__xgafv=None)

 
Get the schema registry instance.

 

-  list(parent, x__xgafv=None)

+  list(parent, view=None, x__xgafv=None)

 
List schema registries.

 
Method Details

 

@@ -201,11 +201,16 @@ 
Method Details

 

 
 

-    list(parent, x__xgafv=None)
+    list(parent, view=None, x__xgafv=None)
   
List schema registries.
 
 Args:
   parent: string, Required. The parent whose schema registry instances are to be listed. Structured like: `projects/{project}/locations/{location}` (required)
+  view: string, Optional. Specifies the view to return for the schema registry instances. If not specified, the default view is SCHEMA_REGISTRY_VIEW_BASIC.
+    Allowed values
+      SCHEMA_REGISTRY_VIEW_UNSPECIFIED - The unset value. The API will default to SCHEMA_REGISTRY_VIEW_BASIC.
+      SCHEMA_REGISTRY_VIEW_BASIC - If SchemaRegistryView is not specified, this is the default value. Returns only the name of the schema registry. The contexts associated with it are not included.
+      SCHEMA_REGISTRY_VIEW_FULL - Returns the name of the schema registry and all the contexts associated with it.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/googleapiclient/discovery_cache/documents/managedkafka.v1.json b/googleapiclient/discovery_cache/documents/managedkafka.v1.json
index 8334464e254..2e60f99d962 100644
--- a/googleapiclient/discovery_cache/documents/managedkafka.v1.json
+++ b/googleapiclient/discovery_cache/documents/managedkafka.v1.json
@@ -1532,6 +1532,21 @@
 "pattern": "^projects/[^/]+/locations/[^/]+$",
 "required": true,
 "type": "string"
+},
+"view": {
+"description": "Optional. Specifies the view to return for the schema registry instances. If not specified, the default view is SCHEMA_REGISTRY_VIEW_BASIC.",
+"enum": [
+"SCHEMA_REGISTRY_VIEW_UNSPECIFIED",
+"SCHEMA_REGISTRY_VIEW_BASIC",
+"SCHEMA_REGISTRY_VIEW_FULL"
+],
+"enumDescriptions": [
+"The unset value. The API will default to SCHEMA_REGISTRY_VIEW_BASIC.",
+"If SchemaRegistryView is not specified, this is the default value. Returns only the name of the schema registry. The contexts associated with it are not included.",
+"Returns the name of the schema registry and all the contexts associated with it."
+],
+"location": "query",
+"type": "string"
 }
 },
 "path": "v1/{+parent}/schemaRegistries",
@@ -2919,7 +2934,7 @@
 }
 }
 },
-"revision": "20250701",
+"revision": "20250731",
 "rootUrl": "https://managedkafka.googleapis.com/",
 "schemas": {
 "AccessConfig": {

From 80dc8c969c24fedb1d76c8c1794c2e78d04d36e5 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:00 +0000
Subject: [PATCH 24/32] feat(merchantapi): update the api

#### merchantapi:ordertracking_v1beta

The following keys were added:
- schemas.LineItemDetails.properties.gtin.deprecated (Total Keys: 1)
- schemas.LineItemDetails.properties.gtins (Total Keys: 2)
---
 ...accounts_v1.accounts.autofeedSettings.html |  144 +
 ...nts_v1.accounts.automaticImprovements.html |  201 +
 ...accounts_v1.accounts.businessIdentity.html |  186 +
 ...api_accounts_v1.accounts.businessInfo.html |  255 +
 ...nts_v1.accounts.developerRegistration.html |  170 +
 ...accounts_v1.accounts.emailPreferences.html |  141 +
 ...tapi_accounts_v1.accounts.gbpAccounts.html |  166 +
 ...hantapi_accounts_v1.accounts.homepage.html |  205 +
 .../dyn/merchantapi_accounts_v1.accounts.html |  454 ++
 ...rchantapi_accounts_v1.accounts.issues.html |  149 +
 ...ounts_v1.accounts.omnichannelSettings.html |  451 ++
 ...unts.omnichannelSettings.lfpProviders.html |  164 +
 ...unts_v1.accounts.onlineReturnPolicies.html |  424 ++
 ...v1.accounts.programs.checkoutSettings.html |  263 +
 ...hantapi_accounts_v1.accounts.programs.html |  271 +
 ...chantapi_accounts_v1.accounts.regions.html |  337 +
 ...pi_accounts_v1.accounts.relationships.html |  196 +
 ...hantapi_accounts_v1.accounts.services.html |  331 +
 ...accounts_v1.accounts.shippingSettings.html | 1049 ++++
 ...ccounts.termsOfServiceAgreementStates.html |  160 +
 ...erchantapi_accounts_v1.accounts.users.html |  259 +
 docs/dyn/merchantapi_accounts_v1.html         |  116 +
 ...erchantapi_accounts_v1.termsOfService.html |  183 +
 ...s_v1beta.accounts.omnichannelSettings.html |   42 +-
 ...ersions_v1.accounts.conversionSources.html |  487 ++
 .../merchantapi_conversions_v1.accounts.html  |   91 +
 docs/dyn/merchantapi_conversions_v1.html      |  111 +
 ...s_v1.accounts.dataSources.fileUploads.html |  124 +
 ...i_datasources_v1.accounts.dataSources.html |  704 +++
 .../merchantapi_datasources_v1.accounts.html  |   91 +
 docs/dyn/merchantapi_datasources_v1.html      |  111 +
 .../merchantapi_inventories_v1.accounts.html  |   91 +
 ...tapi_inventories_v1.accounts.products.html |   96 +
 ...v1.accounts.products.localInventories.html |  245 +
 ...accounts.products.regionalInventories.html |  233 +
 docs/dyn/merchantapi_inventories_v1.html      |  111 +
 ..._v1.accounts.aggregateProductStatuses.html |  153 +
 ...rchantapi_issueresolution_v1.accounts.html |   91 +
 docs/dyn/merchantapi_issueresolution_v1.html  |  116 +
 ...pi_issueresolution_v1.issueresolution.html |  417 ++
 ...hantapi_lfp_v1beta.accounts.lfpStores.html |    8 +-
 ...merchantapi_notifications_v1.accounts.html |   91 +
 ...v1.accounts.notificationsubscriptions.html |  258 +
 docs/dyn/merchantapi_notifications_v1.html    |  111 +
 ...merchantapi_ordertracking_v1.accounts.html |   91 +
 ...king_v1.accounts.orderTrackingSignals.html |  334 +
 docs/dyn/merchantapi_ordertracking_v1.html    |  111 +
 ..._v1beta.accounts.orderTrackingSignals.html |    6 +
 .../dyn/merchantapi_products_v1.accounts.html |   96 +
 ...pi_products_v1.accounts.productInputs.html | 1337 ++++
 ...hantapi_products_v1.accounts.products.html |  834 +++
 docs/dyn/merchantapi_products_v1.html         |  111 +
 .../merchantapi_promotions_v1.accounts.html   |   91 +
 ...api_promotions_v1.accounts.promotions.html |  642 ++
 docs/dyn/merchantapi_promotions_v1.html       |  111 +
 ...promotions_v1beta.accounts.promotions.html |    4 +-
 docs/dyn/merchantapi_quota_v1.accounts.html   |   91 +
 .../merchantapi_quota_v1.accounts.quotas.html |  143 +
 docs/dyn/merchantapi_quota_v1.html            |  111 +
 docs/dyn/merchantapi_reports_v1.accounts.html |   91 +
 ...rchantapi_reports_v1.accounts.reports.html |  398 ++
 docs/dyn/merchantapi_reports_v1.html          |  111 +
 ...ntapi_reports_v1beta.accounts.reports.html |    2 +-
 .../documents/merchantapi.accounts_v1.json    | 5402 +++++++++++++++++
 .../merchantapi.accounts_v1beta.json          |    8 +-
 .../documents/merchantapi.conversions_v1.json |  650 ++
 .../documents/merchantapi.datasources_v1.json | 1037 ++++
 .../documents/merchantapi.inventories_v1.json |  713 +++
 .../merchantapi.issueresolution_v1.json       | 1248 ++++
 .../documents/merchantapi.lfp_v1beta.json     |    4 +-
 .../merchantapi.notifications_v1.json         |  483 ++
 .../merchantapi.ordertracking_v1.json         |  569 ++
 .../merchantapi.ordertracking_v1beta.json     |   10 +-
 .../documents/merchantapi.products_v1.json    | 2125 +++++++
 .../documents/merchantapi.promotions_v1.json  | 1034 ++++
 .../merchantapi.promotions_v1beta.json        |    6 +-
 .../documents/merchantapi.quota_v1.json       |  393 ++
 .../documents/merchantapi.reports_v1.json     | 1550 +++++
 .../documents/merchantapi.reports_v1beta.json |    4 +-
 79 files changed, 29968 insertions(+), 40 deletions(-)
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.autofeedSettings.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.automaticImprovements.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.businessIdentity.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.businessInfo.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.developerRegistration.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.emailPreferences.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.gbpAccounts.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.homepage.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.issues.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.lfpProviders.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.onlineReturnPolicies.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.programs.checkoutSettings.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.programs.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.regions.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.relationships.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.services.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.shippingSettings.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.termsOfServiceAgreementStates.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.accounts.users.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1.termsOfService.html
 create mode 100644 docs/dyn/merchantapi_conversions_v1.accounts.conversionSources.html
 create mode 100644 docs/dyn/merchantapi_conversions_v1.accounts.html
 create mode 100644 docs/dyn/merchantapi_conversions_v1.html
 create mode 100644 docs/dyn/merchantapi_datasources_v1.accounts.dataSources.fileUploads.html
 create mode 100644 docs/dyn/merchantapi_datasources_v1.accounts.dataSources.html
 create mode 100644 docs/dyn/merchantapi_datasources_v1.accounts.html
 create mode 100644 docs/dyn/merchantapi_datasources_v1.html
 create mode 100644 docs/dyn/merchantapi_inventories_v1.accounts.html
 create mode 100644 docs/dyn/merchantapi_inventories_v1.accounts.products.html
 create mode 100644 docs/dyn/merchantapi_inventories_v1.accounts.products.localInventories.html
 create mode 100644 docs/dyn/merchantapi_inventories_v1.accounts.products.regionalInventories.html
 create mode 100644 docs/dyn/merchantapi_inventories_v1.html
 create mode 100644 docs/dyn/merchantapi_issueresolution_v1.accounts.aggregateProductStatuses.html
 create mode 100644 docs/dyn/merchantapi_issueresolution_v1.accounts.html
 create mode 100644 docs/dyn/merchantapi_issueresolution_v1.html
 create mode 100644 docs/dyn/merchantapi_issueresolution_v1.issueresolution.html
 create mode 100644 docs/dyn/merchantapi_notifications_v1.accounts.html
 create mode 100644 docs/dyn/merchantapi_notifications_v1.accounts.notificationsubscriptions.html
 create mode 100644 docs/dyn/merchantapi_notifications_v1.html
 create mode 100644 docs/dyn/merchantapi_ordertracking_v1.accounts.html
 create mode 100644 docs/dyn/merchantapi_ordertracking_v1.accounts.orderTrackingSignals.html
 create mode 100644 docs/dyn/merchantapi_ordertracking_v1.html
 create mode 100644 docs/dyn/merchantapi_products_v1.accounts.html
 create mode 100644 docs/dyn/merchantapi_products_v1.accounts.productInputs.html
 create mode 100644 docs/dyn/merchantapi_products_v1.accounts.products.html
 create mode 100644 docs/dyn/merchantapi_products_v1.html
 create mode 100644 docs/dyn/merchantapi_promotions_v1.accounts.html
 create mode 100644 docs/dyn/merchantapi_promotions_v1.accounts.promotions.html
 create mode 100644 docs/dyn/merchantapi_promotions_v1.html
 create mode 100644 docs/dyn/merchantapi_quota_v1.accounts.html
 create mode 100644 docs/dyn/merchantapi_quota_v1.accounts.quotas.html
 create mode 100644 docs/dyn/merchantapi_quota_v1.html
 create mode 100644 docs/dyn/merchantapi_reports_v1.accounts.html
 create mode 100644 docs/dyn/merchantapi_reports_v1.accounts.reports.html
 create mode 100644 docs/dyn/merchantapi_reports_v1.html
 create mode 100644 googleapiclient/discovery_cache/documents/merchantapi.accounts_v1.json
 create mode 100644 googleapiclient/discovery_cache/documents/merchantapi.conversions_v1.json
 create mode 100644 googleapiclient/discovery_cache/documents/merchantapi.datasources_v1.json
 create mode 100644 googleapiclient/discovery_cache/documents/merchantapi.inventories_v1.json
 create mode 100644 googleapiclient/discovery_cache/documents/merchantapi.issueresolution_v1.json
 create mode 100644 googleapiclient/discovery_cache/documents/merchantapi.notifications_v1.json
 create mode 100644 googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1.json
 create mode 100644 googleapiclient/discovery_cache/documents/merchantapi.products_v1.json
 create mode 100644 googleapiclient/discovery_cache/documents/merchantapi.promotions_v1.json
 create mode 100644 googleapiclient/discovery_cache/documents/merchantapi.quota_v1.json
 create mode 100644 googleapiclient/discovery_cache/documents/merchantapi.reports_v1.json

diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.autofeedSettings.html b/docs/dyn/merchantapi_accounts_v1.accounts.autofeedSettings.html
new file mode 100644
index 00000000000..d99c59f33a8
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.autofeedSettings.html
@@ -0,0 +1,144 @@
+
+
+
+
Merchant API . accounts . autofeedSettings

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  getAutofeedSettings(name, x__xgafv=None)

+
Retrieves the autofeed settings of an account.

+

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

+
Updates the autofeed settings of an account.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    getAutofeedSettings(name, x__xgafv=None)
+  
Retrieves the autofeed settings of an account.
+
+Args:
+  name: string, Required. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Collection of information related to the [autofeed](https://support.google.com/merchants/answer/7538732) settings.
+  "eligible": True or False, # Output only. Determines whether the business is eligible for being enrolled into an autofeed.
+  "enableProducts": True or False, # Required. Enables or disables product crawling through the autofeed for the given account. Autofeed accounts must meet [certain conditions](https://support.google.com/merchants/answer/7538732#Configure_automated_feeds_Standard_Experience), which can be checked through the `eligible` field. The account must **not** be a marketplace. When the autofeed is enabled for the first time, the products usually appear instantly. When re-enabling, it might take up to 24 hours for products to appear.
+  "name": "A String", # Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`.
+}

+

+
+

+    updateAutofeedSettings(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates the autofeed settings of an account.
+
+Args:
+  name: string, Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Collection of information related to the [autofeed](https://support.google.com/merchants/answer/7538732) settings.
+  "eligible": True or False, # Output only. Determines whether the business is eligible for being enrolled into an autofeed.
+  "enableProducts": True or False, # Required. Enables or disables product crawling through the autofeed for the given account. Autofeed accounts must meet [certain conditions](https://support.google.com/merchants/answer/7538732#Configure_automated_feeds_Standard_Experience), which can be checked through the `eligible` field. The account must **not** be a marketplace. When the autofeed is enabled for the first time, the products usually appear instantly. When re-enabling, it might take up to 24 hours for products to appear.
+  "name": "A String", # Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`.
+}
+
+  updateMask: string, Required. List of fields being updated.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Collection of information related to the [autofeed](https://support.google.com/merchants/answer/7538732) settings.
+  "eligible": True or False, # Output only. Determines whether the business is eligible for being enrolled into an autofeed.
+  "enableProducts": True or False, # Required. Enables or disables product crawling through the autofeed for the given account. Autofeed accounts must meet [certain conditions](https://support.google.com/merchants/answer/7538732#Configure_automated_feeds_Standard_Experience), which can be checked through the `eligible` field. The account must **not** be a marketplace. When the autofeed is enabled for the first time, the products usually appear instantly. When re-enabling, it might take up to 24 hours for products to appear.
+  "name": "A String", # Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.automaticImprovements.html b/docs/dyn/merchantapi_accounts_v1.accounts.automaticImprovements.html
new file mode 100644
index 00000000000..22fd4a88965
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.automaticImprovements.html
@@ -0,0 +1,201 @@
+
+
+
+
Merchant API . accounts . automaticImprovements

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  getAutomaticImprovements(name, x__xgafv=None)

+
Retrieves the automatic improvements of an account.

+

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

+
Updates the automatic improvements of an account.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    getAutomaticImprovements(name, x__xgafv=None)
+  
Retrieves the automatic improvements of an account.
+
+Args:
+  name: string, Required. The resource name of the automatic improvements. Format: `accounts/{account}/automaticImprovements` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Collection of information related to the [automatic improvements](https://developers.google.com/shopping-content/guides/automatic-improvements) of an account.
+  "imageImprovements": { # This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) # This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) This field is only updated (cleared) if provided in the update mask.
+    "accountImageImprovementsSettings": { # Settings for the Automatic Image Improvements. # Optional. Determines how the images should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.
+      "allowAutomaticImageImprovements": True or False, # Enables automatic image improvements.
+    },
+    "effectiveAllowAutomaticImageImprovements": True or False, # Output only. The effective value of allow_automatic_image_improvements. If account_image_improvements_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
+  },
+  "itemUpdates": { # Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. # Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. This field is only updated (cleared) if provided in the update mask.
+    "accountItemUpdatesSettings": { # Settings for the Automatic Item Updates. # Optional. Determines which attributes of the items should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.
+      "allowAvailabilityUpdates": True or False, # If availability updates are enabled, any previous availability values get overwritten if Google finds an out-of-stock annotation on the offer's page. If additionally `allow_strict_availability_updates` field is set to true, values get overwritten if Google finds an in-stock annotation on the offer’s page.
+      "allowConditionUpdates": True or False, # If condition updates are enabled, Google always updates item condition with the condition detected from the details of your product.
+      "allowPriceUpdates": True or False, # If price updates are enabled, Google always updates the active price with the crawled information.
+      "allowStrictAvailabilityUpdates": True or False, # If `allow_availability_updates` is enabled, items are automatically updated in all your Shopping target countries. By default, availability updates will only be applied to items that are 'out of stock' on your website but 'in stock' on Shopping. Set this to true to also update items that are 'in stock' on your website, but 'out of stock' on Google Shopping. In order for this field to have an effect, you must also set `allow_availability_updates`.
+    },
+    "effectiveAllowAvailabilityUpdates": True or False, # Output only. The effective value of allow_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+    "effectiveAllowConditionUpdates": True or False, # Output only. The effective value of allow_condition_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+    "effectiveAllowPriceUpdates": True or False, # Output only. The effective value of allow_price_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+    "effectiveAllowStrictAvailabilityUpdates": True or False, # Output only. The effective value of allow_strict_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+  },
+  "name": "A String", # Identifier. The resource name of the automatic improvements. Format: `accounts/{account}/automaticImprovements`.
+  "shippingImprovements": { # Not available for [advanced accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data # Not available for [advanced accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data This field is only updated (cleared) if provided in the update mask.
+    "allowShippingImprovements": True or False, # Enables automatic shipping improvements.
+  },
+}

+

+
+

+    updateAutomaticImprovements(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates the automatic improvements of an account.
+
+Args:
+  name: string, Identifier. The resource name of the automatic improvements. Format: `accounts/{account}/automaticImprovements`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Collection of information related to the [automatic improvements](https://developers.google.com/shopping-content/guides/automatic-improvements) of an account.
+  "imageImprovements": { # This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) # This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) This field is only updated (cleared) if provided in the update mask.
+    "accountImageImprovementsSettings": { # Settings for the Automatic Image Improvements. # Optional. Determines how the images should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.
+      "allowAutomaticImageImprovements": True or False, # Enables automatic image improvements.
+    },
+    "effectiveAllowAutomaticImageImprovements": True or False, # Output only. The effective value of allow_automatic_image_improvements. If account_image_improvements_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
+  },
+  "itemUpdates": { # Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. # Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. This field is only updated (cleared) if provided in the update mask.
+    "accountItemUpdatesSettings": { # Settings for the Automatic Item Updates. # Optional. Determines which attributes of the items should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.
+      "allowAvailabilityUpdates": True or False, # If availability updates are enabled, any previous availability values get overwritten if Google finds an out-of-stock annotation on the offer's page. If additionally `allow_strict_availability_updates` field is set to true, values get overwritten if Google finds an in-stock annotation on the offer’s page.
+      "allowConditionUpdates": True or False, # If condition updates are enabled, Google always updates item condition with the condition detected from the details of your product.
+      "allowPriceUpdates": True or False, # If price updates are enabled, Google always updates the active price with the crawled information.
+      "allowStrictAvailabilityUpdates": True or False, # If `allow_availability_updates` is enabled, items are automatically updated in all your Shopping target countries. By default, availability updates will only be applied to items that are 'out of stock' on your website but 'in stock' on Shopping. Set this to true to also update items that are 'in stock' on your website, but 'out of stock' on Google Shopping. In order for this field to have an effect, you must also set `allow_availability_updates`.
+    },
+    "effectiveAllowAvailabilityUpdates": True or False, # Output only. The effective value of allow_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+    "effectiveAllowConditionUpdates": True or False, # Output only. The effective value of allow_condition_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+    "effectiveAllowPriceUpdates": True or False, # Output only. The effective value of allow_price_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+    "effectiveAllowStrictAvailabilityUpdates": True or False, # Output only. The effective value of allow_strict_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+  },
+  "name": "A String", # Identifier. The resource name of the automatic improvements. Format: `accounts/{account}/automaticImprovements`.
+  "shippingImprovements": { # Not available for [advanced accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data # Not available for [advanced accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data This field is only updated (cleared) if provided in the update mask.
+    "allowShippingImprovements": True or False, # Enables automatic shipping improvements.
+  },
+}
+
+  updateMask: string, Required. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `item_updates` - `item_updates.account_level_settings` - `image_improvements` - `image_improvements.account_level_settings` - `shipping_improvements` - `shipping_improvements.allow_shipping_improvements`
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Collection of information related to the [automatic improvements](https://developers.google.com/shopping-content/guides/automatic-improvements) of an account.
+  "imageImprovements": { # This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) # This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) This field is only updated (cleared) if provided in the update mask.
+    "accountImageImprovementsSettings": { # Settings for the Automatic Image Improvements. # Optional. Determines how the images should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.
+      "allowAutomaticImageImprovements": True or False, # Enables automatic image improvements.
+    },
+    "effectiveAllowAutomaticImageImprovements": True or False, # Output only. The effective value of allow_automatic_image_improvements. If account_image_improvements_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
+  },
+  "itemUpdates": { # Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. # Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. This field is only updated (cleared) if provided in the update mask.
+    "accountItemUpdatesSettings": { # Settings for the Automatic Item Updates. # Optional. Determines which attributes of the items should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.
+      "allowAvailabilityUpdates": True or False, # If availability updates are enabled, any previous availability values get overwritten if Google finds an out-of-stock annotation on the offer's page. If additionally `allow_strict_availability_updates` field is set to true, values get overwritten if Google finds an in-stock annotation on the offer’s page.
+      "allowConditionUpdates": True or False, # If condition updates are enabled, Google always updates item condition with the condition detected from the details of your product.
+      "allowPriceUpdates": True or False, # If price updates are enabled, Google always updates the active price with the crawled information.
+      "allowStrictAvailabilityUpdates": True or False, # If `allow_availability_updates` is enabled, items are automatically updated in all your Shopping target countries. By default, availability updates will only be applied to items that are 'out of stock' on your website but 'in stock' on Shopping. Set this to true to also update items that are 'in stock' on your website, but 'out of stock' on Google Shopping. In order for this field to have an effect, you must also set `allow_availability_updates`.
+    },
+    "effectiveAllowAvailabilityUpdates": True or False, # Output only. The effective value of allow_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+    "effectiveAllowConditionUpdates": True or False, # Output only. The effective value of allow_condition_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+    "effectiveAllowPriceUpdates": True or False, # Output only. The effective value of allow_price_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+    "effectiveAllowStrictAvailabilityUpdates": True or False, # Output only. The effective value of allow_strict_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
+  },
+  "name": "A String", # Identifier. The resource name of the automatic improvements. Format: `accounts/{account}/automaticImprovements`.
+  "shippingImprovements": { # Not available for [advanced accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data # Not available for [advanced accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data This field is only updated (cleared) if provided in the update mask.
+    "allowShippingImprovements": True or False, # Enables automatic shipping improvements.
+  },
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.businessIdentity.html b/docs/dyn/merchantapi_accounts_v1.accounts.businessIdentity.html
new file mode 100644
index 00000000000..17c93e408b0
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.businessIdentity.html
@@ -0,0 +1,186 @@
+
+
+
+
Merchant API . accounts . businessIdentity

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  getBusinessIdentity(name, x__xgafv=None)

+
Retrieves the business identity of an account.

+

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

+
Updates the business identity of an account. Executing this method requires admin access.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    getBusinessIdentity(name, x__xgafv=None)
+  
Retrieves the business identity of an account.
+
+Args:
+  name: string, Required. The resource name of the business identity. Format: `accounts/{account}/businessIdentity`. For example, `accounts/123456/businessIdentity`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Collection of information related to the [identity of a business](https://support.google.com/merchants/answer/12564247).
+  "blackOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being black-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "latinoOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being latino-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "name": "A String", # Identifier. The resource name of the business identity. Format: `accounts/{account}/businessIdentity`
+  "promotionsConsent": "A String", # Required. Whether the identity attributes may be used for promotions.
+  "smallBusiness": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as a small business. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "veteranOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being veteran-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "womenOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being women-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+}

+

+
+

+    updateBusinessIdentity(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates the business identity of an account. Executing this method requires admin access.
+
+Args:
+  name: string, Identifier. The resource name of the business identity. Format: `accounts/{account}/businessIdentity` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Collection of information related to the [identity of a business](https://support.google.com/merchants/answer/12564247).
+  "blackOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being black-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "latinoOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being latino-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "name": "A String", # Identifier. The resource name of the business identity. Format: `accounts/{account}/businessIdentity`
+  "promotionsConsent": "A String", # Required. Whether the identity attributes may be used for promotions.
+  "smallBusiness": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as a small business. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "veteranOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being veteran-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "womenOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being women-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+}
+
+  updateMask: string, Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `black_owned` - `latino_owned` - `promotions_consent` - `small_business` - `veteran_owned` - `women_owned`
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Collection of information related to the [identity of a business](https://support.google.com/merchants/answer/12564247).
+  "blackOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being black-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "latinoOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being latino-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "name": "A String", # Identifier. The resource name of the business identity. Format: `accounts/{account}/businessIdentity`
+  "promotionsConsent": "A String", # Required. Whether the identity attributes may be used for promotions.
+  "smallBusiness": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as a small business. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "veteranOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being veteran-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+  "womenOwned": { # All information related to an identity attribute. # Optional. Specifies whether the business identifies itself as being women-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers.
+    "identityDeclaration": "A String", # Required. The declaration of identity for this attribute.
+  },
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.businessInfo.html b/docs/dyn/merchantapi_accounts_v1.accounts.businessInfo.html
new file mode 100644
index 00000000000..c1221cee64c
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.businessInfo.html
@@ -0,0 +1,255 @@
+
+
+
+
Merchant API . accounts . businessInfo

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  getBusinessInfo(name, x__xgafv=None)

+
Retrieves the business info of an account.

+

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

+
Updates the business info of an account. Executing this method requires admin access.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    getBusinessInfo(name, x__xgafv=None)
+  
Retrieves the business info of an account.
+
+Args:
+  name: string, Required. The resource name of the business info. Format: `accounts/{account}/businessInfo`. For example, `accounts/123456/businessInfo`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `BusinessInfo` message contains essential information about a business. This message captures key business details such as physical address, customer service contacts, and region-specific identifiers.
+  "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. # Optional. The address of the business. Only `region_code`, `address_lines`, `postal_code`, `administrative_area` and `locality` fields are supported. All other fields are ignored.
+    "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. 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 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 (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 (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.
+  },
+  "customerService": { # Customer service information. # Optional. The customer service of the business.
+    "email": "A String", # Optional. The email address where customer service may be reached.
+    "phone": { # An object representing a phone number, suitable as an API wire format. This representation: - should not be used for locale-specific formatting of a phone number, such as "+1 (650) 253-0000 ext. 123" - is not designed for efficient storage - may not be suitable for dialing - specialized libraries (see references) should be used to parse the number for that purpose To do something meaningful with this number, such as format it for various use-cases, convert it to an `i18n.phonenumbers.PhoneNumber` object first. For instance, in Java this would be: com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); } Reference(s): - https://github.com/google/libphonenumber # Optional. The phone number where customer service may be called.
+      "e164Number": "A String", # The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: "+15552220123" - incorrect: "+1 (555) 222-01234 x123" The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes
+      "extension": "A String", # The phone number's extension. The extension is not standardized in ITU recommendations, except for being defined as a series of numbers with a maximum length of 40 digits. Other than digits, some other dialing characters such as ',' (indicating a wait) or '#' may be stored here. Note that no regions currently use extensions with short codes, so this field is normally only set in conjunction with an E.164 number. It is held separately from the E.164 number to allow for short code extensions in the future.
+      "shortCode": { # An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (For example "Text 611 to see how many minutes you have remaining on your plan."). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (For example: US and CA). # A short code. Reference(s): - https://wikipedia.org/wiki/Short_code
+        "number": "A String", # Required. The short code digits, without a leading plus ('+') or country calling code. For example "611".
+        "regionCode": "A String", # Required. The BCP-47 region code of the location where calls to this short code can be made, such as "US" and "BB". Reference(s): - http://www.unicode.org/reports/tr35/#unicode_region_subtag
+      },
+    },
+    "uri": "A String", # Optional. The URI where customer service may be found.
+  },
+  "koreanBusinessRegistrationNumber": "A String", # Optional. The 10-digit [Korean business registration number](https://support.google.com/merchants/answer/9037766) separated with dashes in the format: XXX-XX-XXXXX.
+  "name": "A String", # Identifier. The resource name of the business info. Format: `accounts/{account}/businessInfo`
+  "phone": { # An object representing a phone number, suitable as an API wire format. This representation: - should not be used for locale-specific formatting of a phone number, such as "+1 (650) 253-0000 ext. 123" - is not designed for efficient storage - may not be suitable for dialing - specialized libraries (see references) should be used to parse the number for that purpose To do something meaningful with this number, such as format it for various use-cases, convert it to an `i18n.phonenumbers.PhoneNumber` object first. For instance, in Java this would be: com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); } Reference(s): - https://github.com/google/libphonenumber # Output only. The phone number of the business.
+    "e164Number": "A String", # The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: "+15552220123" - incorrect: "+1 (555) 222-01234 x123" The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes
+    "extension": "A String", # The phone number's extension. The extension is not standardized in ITU recommendations, except for being defined as a series of numbers with a maximum length of 40 digits. Other than digits, some other dialing characters such as ',' (indicating a wait) or '#' may be stored here. Note that no regions currently use extensions with short codes, so this field is normally only set in conjunction with an E.164 number. It is held separately from the E.164 number to allow for short code extensions in the future.
+    "shortCode": { # An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (For example "Text 611 to see how many minutes you have remaining on your plan."). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (For example: US and CA). # A short code. Reference(s): - https://wikipedia.org/wiki/Short_code
+      "number": "A String", # Required. The short code digits, without a leading plus ('+') or country calling code. For example "611".
+      "regionCode": "A String", # Required. The BCP-47 region code of the location where calls to this short code can be made, such as "US" and "BB". Reference(s): - http://www.unicode.org/reports/tr35/#unicode_region_subtag
+    },
+  },
+  "phoneVerificationState": "A String", # Output only. The phone verification state of the business.
+}

+

+
+

+    updateBusinessInfo(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates the business info of an account. Executing this method requires admin access.
+
+Args:
+  name: string, Identifier. The resource name of the business info. Format: `accounts/{account}/businessInfo` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The `BusinessInfo` message contains essential information about a business. This message captures key business details such as physical address, customer service contacts, and region-specific identifiers.
+  "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. # Optional. The address of the business. Only `region_code`, `address_lines`, `postal_code`, `administrative_area` and `locality` fields are supported. All other fields are ignored.
+    "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. 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 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 (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 (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.
+  },
+  "customerService": { # Customer service information. # Optional. The customer service of the business.
+    "email": "A String", # Optional. The email address where customer service may be reached.
+    "phone": { # An object representing a phone number, suitable as an API wire format. This representation: - should not be used for locale-specific formatting of a phone number, such as "+1 (650) 253-0000 ext. 123" - is not designed for efficient storage - may not be suitable for dialing - specialized libraries (see references) should be used to parse the number for that purpose To do something meaningful with this number, such as format it for various use-cases, convert it to an `i18n.phonenumbers.PhoneNumber` object first. For instance, in Java this would be: com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); } Reference(s): - https://github.com/google/libphonenumber # Optional. The phone number where customer service may be called.
+      "e164Number": "A String", # The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: "+15552220123" - incorrect: "+1 (555) 222-01234 x123" The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes
+      "extension": "A String", # The phone number's extension. The extension is not standardized in ITU recommendations, except for being defined as a series of numbers with a maximum length of 40 digits. Other than digits, some other dialing characters such as ',' (indicating a wait) or '#' may be stored here. Note that no regions currently use extensions with short codes, so this field is normally only set in conjunction with an E.164 number. It is held separately from the E.164 number to allow for short code extensions in the future.
+      "shortCode": { # An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (For example "Text 611 to see how many minutes you have remaining on your plan."). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (For example: US and CA). # A short code. Reference(s): - https://wikipedia.org/wiki/Short_code
+        "number": "A String", # Required. The short code digits, without a leading plus ('+') or country calling code. For example "611".
+        "regionCode": "A String", # Required. The BCP-47 region code of the location where calls to this short code can be made, such as "US" and "BB". Reference(s): - http://www.unicode.org/reports/tr35/#unicode_region_subtag
+      },
+    },
+    "uri": "A String", # Optional. The URI where customer service may be found.
+  },
+  "koreanBusinessRegistrationNumber": "A String", # Optional. The 10-digit [Korean business registration number](https://support.google.com/merchants/answer/9037766) separated with dashes in the format: XXX-XX-XXXXX.
+  "name": "A String", # Identifier. The resource name of the business info. Format: `accounts/{account}/businessInfo`
+  "phone": { # An object representing a phone number, suitable as an API wire format. This representation: - should not be used for locale-specific formatting of a phone number, such as "+1 (650) 253-0000 ext. 123" - is not designed for efficient storage - may not be suitable for dialing - specialized libraries (see references) should be used to parse the number for that purpose To do something meaningful with this number, such as format it for various use-cases, convert it to an `i18n.phonenumbers.PhoneNumber` object first. For instance, in Java this would be: com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); } Reference(s): - https://github.com/google/libphonenumber # Output only. The phone number of the business.
+    "e164Number": "A String", # The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: "+15552220123" - incorrect: "+1 (555) 222-01234 x123" The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes
+    "extension": "A String", # The phone number's extension. The extension is not standardized in ITU recommendations, except for being defined as a series of numbers with a maximum length of 40 digits. Other than digits, some other dialing characters such as ',' (indicating a wait) or '#' may be stored here. Note that no regions currently use extensions with short codes, so this field is normally only set in conjunction with an E.164 number. It is held separately from the E.164 number to allow for short code extensions in the future.
+    "shortCode": { # An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (For example "Text 611 to see how many minutes you have remaining on your plan."). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (For example: US and CA). # A short code. Reference(s): - https://wikipedia.org/wiki/Short_code
+      "number": "A String", # Required. The short code digits, without a leading plus ('+') or country calling code. For example "611".
+      "regionCode": "A String", # Required. The BCP-47 region code of the location where calls to this short code can be made, such as "US" and "BB". Reference(s): - http://www.unicode.org/reports/tr35/#unicode_region_subtag
+    },
+  },
+  "phoneVerificationState": "A String", # Output only. The phone verification state of the business.
+}
+
+  updateMask: string, Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `address` - `customer_service` - `korean_business_registration_number`
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `BusinessInfo` message contains essential information about a business. This message captures key business details such as physical address, customer service contacts, and region-specific identifiers.
+  "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. # Optional. The address of the business. Only `region_code`, `address_lines`, `postal_code`, `administrative_area` and `locality` fields are supported. All other fields are ignored.
+    "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. 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 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 (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 (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.
+  },
+  "customerService": { # Customer service information. # Optional. The customer service of the business.
+    "email": "A String", # Optional. The email address where customer service may be reached.
+    "phone": { # An object representing a phone number, suitable as an API wire format. This representation: - should not be used for locale-specific formatting of a phone number, such as "+1 (650) 253-0000 ext. 123" - is not designed for efficient storage - may not be suitable for dialing - specialized libraries (see references) should be used to parse the number for that purpose To do something meaningful with this number, such as format it for various use-cases, convert it to an `i18n.phonenumbers.PhoneNumber` object first. For instance, in Java this would be: com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); } Reference(s): - https://github.com/google/libphonenumber # Optional. The phone number where customer service may be called.
+      "e164Number": "A String", # The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: "+15552220123" - incorrect: "+1 (555) 222-01234 x123" The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes
+      "extension": "A String", # The phone number's extension. The extension is not standardized in ITU recommendations, except for being defined as a series of numbers with a maximum length of 40 digits. Other than digits, some other dialing characters such as ',' (indicating a wait) or '#' may be stored here. Note that no regions currently use extensions with short codes, so this field is normally only set in conjunction with an E.164 number. It is held separately from the E.164 number to allow for short code extensions in the future.
+      "shortCode": { # An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (For example "Text 611 to see how many minutes you have remaining on your plan."). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (For example: US and CA). # A short code. Reference(s): - https://wikipedia.org/wiki/Short_code
+        "number": "A String", # Required. The short code digits, without a leading plus ('+') or country calling code. For example "611".
+        "regionCode": "A String", # Required. The BCP-47 region code of the location where calls to this short code can be made, such as "US" and "BB". Reference(s): - http://www.unicode.org/reports/tr35/#unicode_region_subtag
+      },
+    },
+    "uri": "A String", # Optional. The URI where customer service may be found.
+  },
+  "koreanBusinessRegistrationNumber": "A String", # Optional. The 10-digit [Korean business registration number](https://support.google.com/merchants/answer/9037766) separated with dashes in the format: XXX-XX-XXXXX.
+  "name": "A String", # Identifier. The resource name of the business info. Format: `accounts/{account}/businessInfo`
+  "phone": { # An object representing a phone number, suitable as an API wire format. This representation: - should not be used for locale-specific formatting of a phone number, such as "+1 (650) 253-0000 ext. 123" - is not designed for efficient storage - may not be suitable for dialing - specialized libraries (see references) should be used to parse the number for that purpose To do something meaningful with this number, such as format it for various use-cases, convert it to an `i18n.phonenumbers.PhoneNumber` object first. For instance, in Java this would be: com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); } Reference(s): - https://github.com/google/libphonenumber # Output only. The phone number of the business.
+    "e164Number": "A String", # The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: "+15552220123" - incorrect: "+1 (555) 222-01234 x123" The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes
+    "extension": "A String", # The phone number's extension. The extension is not standardized in ITU recommendations, except for being defined as a series of numbers with a maximum length of 40 digits. Other than digits, some other dialing characters such as ',' (indicating a wait) or '#' may be stored here. Note that no regions currently use extensions with short codes, so this field is normally only set in conjunction with an E.164 number. It is held separately from the E.164 number to allow for short code extensions in the future.
+    "shortCode": { # An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (For example "Text 611 to see how many minutes you have remaining on your plan."). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (For example: US and CA). # A short code. Reference(s): - https://wikipedia.org/wiki/Short_code
+      "number": "A String", # Required. The short code digits, without a leading plus ('+') or country calling code. For example "611".
+      "regionCode": "A String", # Required. The BCP-47 region code of the location where calls to this short code can be made, such as "US" and "BB". Reference(s): - http://www.unicode.org/reports/tr35/#unicode_region_subtag
+    },
+  },
+  "phoneVerificationState": "A String", # Output only. The phone verification state of the business.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.developerRegistration.html b/docs/dyn/merchantapi_accounts_v1.accounts.developerRegistration.html
new file mode 100644
index 00000000000..a8fdf21f4fb
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.developerRegistration.html
@@ -0,0 +1,170 @@
+
+
+
+
Merchant API . accounts . developerRegistration

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

+

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

+
Unregister the calling GCP from the calling shopping account. Note that the GCP will still be able to access the API for at most 1 day from the unregister succussful call.

+
Method Details

+

+    close()
+  
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.
+
+Args:
+  name: string, Required. The name of the developer registration to be created for the merchant account that the GCP will be registered with. Format: `accounts/{account}/developerRegistration` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the RegisterGCP method.
+  "developerEmail": "A String", # 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
+}
+
+  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.
+}

+

+
+

+    unregisterGcp(name, body=None, x__xgafv=None)
+  
Unregister the calling GCP from the calling shopping account. Note that the GCP will still be able to access the API for at most 1 day from the unregister succussful call.
+
+Args:
+  name: string, Required. The name of the developer registration to be created for the merchant account that the GCP will be registered with. Format: `accounts/{account}/developerRegistration` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the UnregisterGCP method.
+}
+
+  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); }
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.emailPreferences.html b/docs/dyn/merchantapi_accounts_v1.accounts.emailPreferences.html
new file mode 100644
index 00000000000..f85084681ae
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.emailPreferences.html
@@ -0,0 +1,141 @@
+
+
+
+
Merchant API . accounts . emailPreferences

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  getEmailPreferences(name, x__xgafv=None)

+
Returns the email preferences for a Merchant Center account user. This service only permits retrieving and updating email preferences for the authenticated user. Use the name=accounts/*/users/me/emailPreferences alias to get preferences for the authenticated user.

+

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

+
Updates the email preferences for a Merchant Center account user. Advanced account users should specify the advanced account rather than a sub-account of the advanced account. Preferences which are not explicitly selected in the update mask will not be updated. It is invalid for updates to specify an UNCONFIRMED opt-in status value. Use the name=accounts/*/users/me/emailPreferences alias to update preferences for the authenticated user.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    getEmailPreferences(name, x__xgafv=None)
+  
Returns the email preferences for a Merchant Center account user. This service only permits retrieving and updating email preferences for the authenticated user. Use the name=accounts/*/users/me/emailPreferences alias to get preferences for the authenticated user.
+
+Args:
+  name: string, Required. The name of the `EmailPreferences` resource. Format: `accounts/{account}/users/{email}/emailPreferences` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The categories of notifications the user opted into / opted out of. The email preferences do not include mandatory announcements as users can't opt out of them.
+  "name": "A String", # Identifier. The name of the EmailPreferences. The endpoint is only supported for the authenticated user.
+  "newsAndTips": "A String", # Optional. Updates on new features, tips and best practices.
+}

+

+
+

+    updateEmailPreferences(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates the email preferences for a Merchant Center account user. Advanced account users should specify the advanced account rather than a sub-account of the advanced account. Preferences which are not explicitly selected in the update mask will not be updated. It is invalid for updates to specify an UNCONFIRMED opt-in status value. Use the name=accounts/*/users/me/emailPreferences alias to update preferences for the authenticated user.
+
+Args:
+  name: string, Identifier. The name of the EmailPreferences. The endpoint is only supported for the authenticated user. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The categories of notifications the user opted into / opted out of. The email preferences do not include mandatory announcements as users can't opt out of them.
+  "name": "A String", # Identifier. The name of the EmailPreferences. The endpoint is only supported for the authenticated user.
+  "newsAndTips": "A String", # Optional. Updates on new features, tips and best practices.
+}
+
+  updateMask: string, Required. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `news_and_tips`
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The categories of notifications the user opted into / opted out of. The email preferences do not include mandatory announcements as users can't opt out of them.
+  "name": "A String", # Identifier. The name of the EmailPreferences. The endpoint is only supported for the authenticated user.
+  "newsAndTips": "A String", # Optional. Updates on new features, tips and best practices.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.gbpAccounts.html b/docs/dyn/merchantapi_accounts_v1.accounts.gbpAccounts.html
new file mode 100644
index 00000000000..7223a2e7cfd
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.gbpAccounts.html
@@ -0,0 +1,166 @@
+
+
+
+
Merchant API . accounts . gbpAccounts

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Link the specified merchant to a GBP account for all countries. To run this method, you must have admin access to the Merchant Center account. If you don't have admin access, the request fails with the error message `User is not an administrator of account {ACCOUNT_ID}`.

+

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

+
List the GBP accounts for a given merchant.

+

+  list_next()

+
Retrieves the next page of results.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    linkGbpAccount(parent, body=None, x__xgafv=None)
+  
Link the specified merchant to a GBP account for all countries. To run this method, you must have admin access to the Merchant Center account. If you don't have admin access, the request fails with the error message `User is not an administrator of account {ACCOUNT_ID}`.
+
+Args:
+  parent: string, Required. The name of the parent resource to which the GBP account is linked. Format: `accounts/{account}`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the LinkGbpAccount method.
+  "gbpEmail": "A String", # Required. The email address of the Business Profile account.
+}
+
+  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 LinkGbpAccount method.
+  "response": { # 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); } # Empty response.
+  },
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
List the GBP accounts for a given merchant.
+
+Args:
+  parent: string, Required. The name of the parent resource under which the GBP accounts are listed. Format: `accounts/{account}`. (required)
+  pageSize: integer, Optional. The maximum number of `GbpAccount` resources to return. The service returns fewer than this value if the number of gbp accounts is less that than the `pageSize`. The default value is 50. The maximum value is 1000; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum.
+  pageToken: string, Optional. A page token, received from a previous `ListGbpAccounts` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `ListGbpAccounts` 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 the ListGbpAccounts method.
+  "gbpAccounts": [ # The GBP accounts from the specified merchant in the specified country.
+    { # Collection of information related to a Google Business Profile (GBP) account.
+      "gbpAccountId": "A String", # The id of the GBP account.
+      "gbpAccountName": "A String", # The name of the Business Profile. For personal accounts: Email id of the owner. For Business accounts: Name of the Business Account.
+      "listingCount": "A String", # Number of listings under this account.
+      "name": "A String", # Identifier. The resource name of the GBP account. Format: `accounts/{account}/gbpAccount/{gbp_account}`
+      "type": "A String", # The type of the Business Profile.
+    },
+  ],
+  "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.
+}

+

+
+

+    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/merchantapi_accounts_v1.accounts.homepage.html b/docs/dyn/merchantapi_accounts_v1.accounts.homepage.html
new file mode 100644
index 00000000000..82e31dd9561
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.homepage.html
@@ -0,0 +1,205 @@
+
+
+
+
Merchant API . accounts . homepage

+
Instance Methods

+

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

+
Claims a store's homepage. Executing this method requires admin access. If the homepage is already claimed, this will recheck the verification (unless the business is exempted from claiming, which also exempts from verification) and return a successful response. If ownership can no longer be verified, it will return an error, but it won't clear the claim. In case of failure, a canonical error message is returned: * PERMISSION_DENIED: User doesn't have the necessary permissions on this Merchant Center account. * FAILED_PRECONDITION: - The account is not a Merchant Center account. - Merchant Center account doesn't have a homepage. - Claiming failed (in this case the error message contains more details).

+

+  close()

+
Close httplib2 connections.

+

+  getHomepage(name, x__xgafv=None)

+
Retrieves a store's homepage.

+

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

+
Unclaims a store's homepage. Executing this method requires admin access.

+

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

+
Updates a store's homepage. Executing this method requires admin access.

+
Method Details

+

+    claim(name, body=None, x__xgafv=None)
+  
Claims a store's homepage. Executing this method requires admin access. If the homepage is already claimed, this will recheck the verification (unless the business is exempted from claiming, which also exempts from verification) and return a successful response. If ownership can no longer be verified, it will return an error, but it won't clear the claim. In case of failure, a canonical error message is returned: * PERMISSION_DENIED: User doesn't have the necessary permissions on this Merchant Center account. * FAILED_PRECONDITION: - The account is not a Merchant Center account. - Merchant Center account doesn't have a homepage. - Claiming failed (in this case the error message contains more details).
+
+Args:
+  name: string, Required. The name of the homepage to claim. Format: `accounts/{account}/homepage` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the `ClaimHomepage` method.
+  "overwrite": True or False, # Optional. When set to `true`, this option removes any existing claim on the requested website from any other account to the account making the request, effectively replacing the previous claim.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `Homepage` message represents a business's store homepage within the system. A business's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the business to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).
+  "claimed": True or False, # Output only. Whether the homepage is claimed. See https://support.google.com/merchants/answer/176793.
+  "name": "A String", # Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`
+  "uri": "A String", # Required. The URI (typically a URL) of the store's homepage.
+}

+

+
+

+    close()
+  
Close httplib2 connections.

+

+
+

+    getHomepage(name, x__xgafv=None)
+  
Retrieves a store's homepage.
+
+Args:
+  name: string, Required. The name of the homepage to retrieve. Format: `accounts/{account}/homepage` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `Homepage` message represents a business's store homepage within the system. A business's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the business to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).
+  "claimed": True or False, # Output only. Whether the homepage is claimed. See https://support.google.com/merchants/answer/176793.
+  "name": "A String", # Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`
+  "uri": "A String", # Required. The URI (typically a URL) of the store's homepage.
+}

+

+
+

+    unclaim(name, body=None, x__xgafv=None)
+  
Unclaims a store's homepage. Executing this method requires admin access.
+
+Args:
+  name: string, Required. The name of the homepage to unclaim. Format: `accounts/{account}/homepage` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the `UnclaimHomepage` method.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `Homepage` message represents a business's store homepage within the system. A business's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the business to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).
+  "claimed": True or False, # Output only. Whether the homepage is claimed. See https://support.google.com/merchants/answer/176793.
+  "name": "A String", # Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`
+  "uri": "A String", # Required. The URI (typically a URL) of the store's homepage.
+}

+

+
+

+    updateHomepage(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates a store's homepage. Executing this method requires admin access.
+
+Args:
+  name: string, Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The `Homepage` message represents a business's store homepage within the system. A business's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the business to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).
+  "claimed": True or False, # Output only. Whether the homepage is claimed. See https://support.google.com/merchants/answer/176793.
+  "name": "A String", # Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`
+  "uri": "A String", # Required. The URI (typically a URL) of the store's homepage.
+}
+
+  updateMask: string, Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `uri`
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `Homepage` message represents a business's store homepage within the system. A business's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the business to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).
+  "claimed": True or False, # Output only. Whether the homepage is claimed. See https://support.google.com/merchants/answer/176793.
+  "name": "A String", # Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`
+  "uri": "A String", # Required. The URI (typically a URL) of the store's homepage.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.html b/docs/dyn/merchantapi_accounts_v1.accounts.html
new file mode 100644
index 00000000000..83bd78fd6d3
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.html
@@ -0,0 +1,454 @@
+
+
+
+
Merchant API . accounts

+
Instance Methods

+

+  autofeedSettings()
+

+
Returns the autofeedSettings Resource.

+
+

+  automaticImprovements()
+

+
Returns the automaticImprovements Resource.

+
+

+  businessIdentity()
+

+
Returns the businessIdentity Resource.

+
+

+  businessInfo()
+

+
Returns the businessInfo Resource.

+
+

+  developerRegistration()
+

+
Returns the developerRegistration Resource.

+
+

+  emailPreferences()
+

+
Returns the emailPreferences Resource.

+
+

+  gbpAccounts()
+

+
Returns the gbpAccounts Resource.

+
+

+  homepage()
+

+
Returns the homepage Resource.

+
+

+  issues()
+

+
Returns the issues Resource.

+
+

+  omnichannelSettings()
+

+
Returns the omnichannelSettings Resource.

+
+

+  onlineReturnPolicies()
+

+
Returns the onlineReturnPolicies Resource.

+
+

+  programs()
+

+
Returns the programs Resource.

+
+

+  regions()
+

+
Returns the regions Resource.

+
+

+  relationships()
+

+
Returns the relationships Resource.

+
+

+  services()
+

+
Returns the services Resource.

+
+

+  shippingSettings()
+

+
Returns the shippingSettings Resource.

+
+

+  termsOfServiceAgreementStates()
+

+
Returns the termsOfServiceAgreementStates Resource.

+
+

+  users()
+

+
Returns the users Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  createAndConfigure(body=None, x__xgafv=None)

+
Creates a Merchant Center account with additional configuration. Adds the user that makes the request as an admin for the new account.

+

+  delete(name, force=None, x__xgafv=None)

+
Deletes the specified account regardless of its type: standalone, advanced account or sub-account. Deleting an advanced account leads to the deletion of all of its sub-accounts. Executing this method requires admin access. The deletion succeeds only if the account does not provide services to any other account and has no processed offers. You can use the `force` parameter to override this.

+

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

+

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

+

+  listSubaccounts(provider, pageSize=None, pageToken=None, x__xgafv=None)

+
List all sub-accounts for a given advanced account. This is a convenience wrapper for the more powerful `accounts.list` method. This method will produce the same results as calling `ListsAccounts` with the following filter: `relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))`

+

+  listSubaccounts_next()

+
Retrieves the next page of results.

+

+  list_next()

+
Retrieves the next page of results.

+

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

+
Updates an account regardless of its type: standalone, advanced account or sub-account. Executing this method requires admin access.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    createAndConfigure(body=None, x__xgafv=None)
+  
Creates a Merchant Center account with additional configuration. Adds the user that makes the request as an admin for the new account.
+
+Args:
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the `CreateAndConfigureAccount` method.
+  "account": { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. # Required. The account to be created.
+    "accountId": "A String", # Output only. The ID of the account.
+    "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.
+    "adultContent": True or False, # Optional. Whether this account contains adult content.
+    "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`.
+    "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}`
+    "testAccount": True or False, # Output only. Whether this is a test account.
+    "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Required. The time zone of the account. On writes, `time_zone` sets both the `reporting_time_zone` and the `display_time_zone`. For reads, `time_zone` always returns the `display_time_zone`. If `display_time_zone` doesn't exist for your account, `time_zone` is empty. The `version` field is not supported, won't be set in responses and will be silently ignored if specified in requests.
+      "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+      "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+    },
+  },
+  "service": [ # Required. An account service between the account to be created and the provider account is initialized as part of the creation. At least one such service needs to be provided. Currently exactly one of these needs to be `account_aggregation` and `accounts.createAndConfigure` method can be used to create a sub-account under an existing advanced account through this method. Additional `account_management` or `product_management` services may be provided.
+    { # Additional instructions to add account services during creation of the account.
+      "accountAggregation": { # `AccountAggregation` payload. # The provider is an [aggregator](https://support.google.com/merchants/answer/188487) for the account. Payload for service type Account Aggregation.
+      },
+      "provider": "A String", # Required. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
+    },
+  ],
+  "user": [ # Optional. Users to be added to the account.
+    { # Instruction for adding a user to the account during creation.
+      "user": { # The `User` message represents a user associated with a Merchant Center account. It is used to manage user permissions and access rights within the account. For more information, see [Frequently asked questions about people and access levels](//support.google.com/merchants/answer/12160472). # Optional. Details about the user to be added. At the moment, only access rights may be specified.
+        "accessRights": [ # Required. The [access rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes) the user has.
+          "A String",
+        ],
+        "name": "A String", # Identifier. The resource name of the user. Format: `accounts/{account}/user/{email}` Use `me` to refer to your own email address, for example `accounts/{account}/users/me`.
+        "state": "A String", # Output only. The state of the user.
+      },
+      "userId": "A String", # Required. The email address of the user (for example, `john.doe@gmail.com`).
+    },
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on.
+  "accountId": "A String", # Output only. The ID of the account.
+  "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.
+  "adultContent": True or False, # Optional. Whether this account contains adult content.
+  "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`.
+  "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}`
+  "testAccount": True or False, # Output only. Whether this is a test account.
+  "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Required. The time zone of the account. On writes, `time_zone` sets both the `reporting_time_zone` and the `display_time_zone`. For reads, `time_zone` always returns the `display_time_zone`. If `display_time_zone` doesn't exist for your account, `time_zone` is empty. The `version` field is not supported, won't be set in responses and will be silently ignored if specified in requests.
+    "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+    "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+  },
+}

+

+
+

+    delete(name, force=None, x__xgafv=None)
+  
Deletes the specified account regardless of its type: standalone, advanced account or sub-account. Deleting an advanced account leads to the deletion of all of its sub-accounts. Executing this method requires admin access. The deletion succeeds only if the account does not provide services to any other account and has no processed offers. You can use the `force` parameter to override this.
+
+Args:
+  name: string, Required. The name of the account to delete. Format: `accounts/{account}` (required)
+  force: boolean, Optional. If set to `true`, the account is deleted even if it provides services to other accounts or has processed offers.
+  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)
+  
Retrieves an account from your Merchant Center account. After inserting, updating, or deleting an account, it may take several minutes before changes take effect.
+
+Args:
+  name: string, Required. The name of the account to retrieve. Format: `accounts/{account}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on.
+  "accountId": "A String", # Output only. The ID of the account.
+  "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.
+  "adultContent": True or False, # Optional. Whether this account contains adult content.
+  "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`.
+  "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}`
+  "testAccount": True or False, # Output only. Whether this is a test account.
+  "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Required. The time zone of the account. On writes, `time_zone` sets both the `reporting_time_zone` and the `display_time_zone`. For reads, `time_zone` always returns the `display_time_zone`. If `display_time_zone` doesn't exist for your account, `time_zone` is empty. The `version` field is not supported, won't be set in responses and will be silently ignored if specified in requests.
+    "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+    "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+  },
+}

+

+
+

+    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.
+
+Args:
+  filter: string, Optional. Returns only accounts that match the [filter](https://developers.google.com/merchant/api/guides/accounts/filter). For more details, see the [filter syntax reference](https://developers.google.com/merchant/api/guides/accounts/filter-syntax).
+  pageSize: integer, Optional. The maximum number of accounts to return. The service may return fewer than this value. If unspecified, at most 250 accounts are returned. The maximum value is 500; values above 500 are coerced to 500.
+  pageToken: string, Optional. A page token, received from a previous `accounts.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided in the `accounts.list` request 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 the `accounts.list` method.
+  "accounts": [ # The accounts matching the `ListAccountsRequest`.
+    { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on.
+      "accountId": "A String", # Output only. The ID of the account.
+      "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.
+      "adultContent": True or False, # Optional. Whether this account contains adult content.
+      "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`.
+      "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}`
+      "testAccount": True or False, # Output only. Whether this is a test account.
+      "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Required. The time zone of the account. On writes, `time_zone` sets both the `reporting_time_zone` and the `display_time_zone`. For reads, `time_zone` always returns the `display_time_zone`. If `display_time_zone` doesn't exist for your account, `time_zone` is empty. The `version` field is not supported, won't be set in responses and will be silently ignored if specified in requests.
+        "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+        "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+      },
+    },
+  ],
+  "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.
+}

+

+
+

+    listSubaccounts(provider, pageSize=None, pageToken=None, x__xgafv=None)
+  
List all sub-accounts for a given advanced account. This is a convenience wrapper for the more powerful `accounts.list` method. This method will produce the same results as calling `ListsAccounts` with the following filter: `relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))`
+
+Args:
+  provider: string, Required. The aggregation service provider. Format: `accounts/{accountId}` (required)
+  pageSize: integer, Optional. The maximum number of accounts to return. The service may return fewer than this value. If unspecified, at most 250 accounts are returned. The maximum value is 500; values above 500 are coerced to 500.
+  pageToken: string, Optional. A page token, received from a previous `accounts.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided in the `accounts.list` request 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 the `ListSubAccounts` method.
+  "accounts": [ # The accounts for which the given parent account is an aggregator.
+    { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on.
+      "accountId": "A String", # Output only. The ID of the account.
+      "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.
+      "adultContent": True or False, # Optional. Whether this account contains adult content.
+      "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`.
+      "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}`
+      "testAccount": True or False, # Output only. Whether this is a test account.
+      "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Required. The time zone of the account. On writes, `time_zone` sets both the `reporting_time_zone` and the `display_time_zone`. For reads, `time_zone` always returns the `display_time_zone`. If `display_time_zone` doesn't exist for your account, `time_zone` is empty. The `version` field is not supported, won't be set in responses and will be silently ignored if specified in requests.
+        "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+        "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+      },
+    },
+  ],
+  "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.
+}

+

+
+

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

+

+
+

+    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 account regardless of its type: standalone, advanced account or sub-account. Executing this method requires admin access.
+
+Args:
+  name: string, Identifier. The resource name of the account. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on.
+  "accountId": "A String", # Output only. The ID of the account.
+  "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.
+  "adultContent": True or False, # Optional. Whether this account contains adult content.
+  "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`.
+  "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}`
+  "testAccount": True or False, # Output only. Whether this is a test account.
+  "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Required. The time zone of the account. On writes, `time_zone` sets both the `reporting_time_zone` and the `display_time_zone`. For reads, `time_zone` always returns the `display_time_zone`. If `display_time_zone` doesn't exist for your account, `time_zone` is empty. The `version` field is not supported, won't be set in responses and will be silently ignored if specified in requests.
+    "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+    "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+  },
+}
+
+  updateMask: string, Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `account_name` - `adult_content` - `language_code` - `time_zone`
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on.
+  "accountId": "A String", # Output only. The ID of the account.
+  "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.
+  "adultContent": True or False, # Optional. Whether this account contains adult content.
+  "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`.
+  "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}`
+  "testAccount": True or False, # Output only. Whether this is a test account.
+  "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Required. The time zone of the account. On writes, `time_zone` sets both the `reporting_time_zone` and the `display_time_zone`. For reads, `time_zone` always returns the `display_time_zone`. If `display_time_zone` doesn't exist for your account, `time_zone` is empty. The `version` field is not supported, won't be set in responses and will be silently ignored if specified in requests.
+    "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+    "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+  },
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.issues.html b/docs/dyn/merchantapi_accounts_v1.accounts.issues.html
new file mode 100644
index 00000000000..72fa5db9e5e
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.issues.html
@@ -0,0 +1,149 @@
+
+
+
+
Merchant API . accounts . issues

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Lists all account issues of a Merchant Center account. When called on a multi-client account, this method only returns issues belonging to that account, not its sub-accounts. To retrieve issues for sub-accounts, you must first call the accounts.listSubaccounts method to obtain a list of sub-accounts, and then call `accounts.issues.list` for each sub-account individually.

+

+  list_next()

+
Retrieves the next page of results.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    list(parent, languageCode=None, pageSize=None, pageToken=None, timeZone=None, x__xgafv=None)
+  
Lists all account issues of a Merchant Center account. When called on a multi-client account, this method only returns issues belonging to that account, not its sub-accounts. To retrieve issues for sub-accounts, you must first call the accounts.listSubaccounts method to obtain a list of sub-accounts, and then call `accounts.issues.list` for each sub-account individually.
+
+Args:
+  parent: string, Required. The parent, which owns this collection of issues. Format: `accounts/{account}` (required)
+  languageCode: string, Optional. The issues in the response will have human-readable fields in the given language. The format is [BCP-47](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. If not value is provided, `en-US` will be used.
+  pageSize: integer, Optional. The maximum number of issues to return. The service may return fewer than this value. If unspecified, at most 50 issues will be returned. The maximum value is 100; values above 100 will be coerced to 100
+  pageToken: string, Optional. A page token, received from a previous `ListAccountIssues` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAccountIssues` must match the call that provided the page token.
+  timeZone: string, Optional. The [IANA](https://www.iana.org/time-zones) timezone used to localize times in human-readable fields. For example 'America/Los_Angeles'. If not set, 'America/Los_Angeles' will be used.
+  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 `ListAccountIssues` method.
+  "accountIssues": [ # The issues from the specified account.
+    { # Issues with your Merchant Center account that can impact all your products. For more information, see [Account-level issues in Merchant Center](https://support.google.com/merchants/answer/12153802?sjid=17798438912526418908-EU#account).
+      "detail": "A String", # Further localized details about the issue.
+      "documentationUri": "A String", # Link to Merchant Center Help Center providing further information about the issue and how to fix it.
+      "impactedDestinations": [ # The impact this issue has on various destinations.
+        { # The impact of the issue on a destination.
+          "impacts": [ # The (negative) impact for various regions on the given destination.
+            { # The impact of the issue on a region.
+              "regionCode": "A String", # The [CLDR region code](https://cldr.unicode.org/) where this issue applies.
+              "severity": "A String", # The severity of the issue on the destination and region.
+            },
+          ],
+          "reportingContext": "A String", # The impacted reporting context.
+        },
+      ],
+      "name": "A String", # Identifier. The resource name of the account issue. Format: `accounts/{account}/issues/{id}`. For example, `accounts/123456/issues/misrepresentation-of-self-or-products-unacceptable-business-practice-policy`.
+      "severity": "A String", # The overall severity of the issue.
+      "title": "A String", # The localized title of the issue.
+    },
+  ],
+  "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.
+}

+

+
+

+    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/merchantapi_accounts_v1.accounts.omnichannelSettings.html b/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.html
new file mode 100644
index 00000000000..652c3e16548
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.html
@@ -0,0 +1,451 @@
+
+
+
+
Merchant API . accounts . omnichannelSettings

+
Instance Methods

+

+  lfpProviders()
+

+
Returns the lfpProviders Resource.

+
+

+  close()

+
Close httplib2 connections.

+

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

+
Create the omnichannel settings for a given merchant.

+

+  get(name, x__xgafv=None)

+
Get the omnichannel settings for a given merchant.

+

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

+
List all the omnichannel settings for a given merchant.

+

+  list_next()

+
Retrieves the next page of results.

+

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

+
Update the omnichannel setting for a given merchant in a given country.

+

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

+
Requests inventory verification for a given merchant in a given country.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, x__xgafv=None)
+  
Create the omnichannel settings for a given merchant.
+
+Args:
+  parent: string, Required. The parent resource where this omnichannel setting will be created. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Collection of information related to the omnichannel settings of a merchant.
+  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+    "state": "A String", # Output only. The state of the URI.
+    "uri": "A String", # Required. The about page URI.
+  },
+  "inStock": { # Collection of information related to InStock. # Optional. The InStock URI and state for this country.
+    "state": "A String", # Output only. The state of the in-stock serving.
+    "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
+  },
+  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+    "contact": "A String", # Required. The name of the contact for the inventory verification process.
+    "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
+    "contactState": "A String", # Output only. The state of the contact verification.
+    "state": "A String", # Output only. The state of the inventory verification process.
+  },
+  "lfpLink": { # Collection of information related to the LFP link. # Output only. The established link to a LFP provider.
+    "externalAccountId": "A String", # Required. The account ID by which this merchant is known to the LFP provider.
+    "lfpProvider": "A String", # Required. The resource name of the LFP provider. Format: `lfpProviders/{lfp_provider}`
+    "state": "A String", # Output only. The state of the LFP link.
+  },
+  "lsfType": "A String", # Required. The Local Store Front type for this country.
+  "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
+  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+    "state": "A String", # Output only. The state of the URI.
+    "uri": "A String", # Required. The on display to order (ODO) policy URI.
+  },
+  "pickup": { # Collection of information related to Pickup. # Optional. The Pickup URI and state for this country.
+    "state": "A String", # Output only. The state of the pickup serving.
+    "uri": "A String", # Required. Pickup product page URI. It is only used for the review of pickup serving. This URI domain should match with the business's homepage.
+  },
+  "regionCode": "A String", # Required. Immutable. Region code defined by [CLDR](https://cldr.unicode.org/). Must be provided in the Create method, and is immutable.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Collection of information related to the omnichannel settings of a merchant.
+  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+    "state": "A String", # Output only. The state of the URI.
+    "uri": "A String", # Required. The about page URI.
+  },
+  "inStock": { # Collection of information related to InStock. # Optional. The InStock URI and state for this country.
+    "state": "A String", # Output only. The state of the in-stock serving.
+    "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
+  },
+  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+    "contact": "A String", # Required. The name of the contact for the inventory verification process.
+    "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
+    "contactState": "A String", # Output only. The state of the contact verification.
+    "state": "A String", # Output only. The state of the inventory verification process.
+  },
+  "lfpLink": { # Collection of information related to the LFP link. # Output only. The established link to a LFP provider.
+    "externalAccountId": "A String", # Required. The account ID by which this merchant is known to the LFP provider.
+    "lfpProvider": "A String", # Required. The resource name of the LFP provider. Format: `lfpProviders/{lfp_provider}`
+    "state": "A String", # Output only. The state of the LFP link.
+  },
+  "lsfType": "A String", # Required. The Local Store Front type for this country.
+  "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
+  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+    "state": "A String", # Output only. The state of the URI.
+    "uri": "A String", # Required. The on display to order (ODO) policy URI.
+  },
+  "pickup": { # Collection of information related to Pickup. # Optional. The Pickup URI and state for this country.
+    "state": "A String", # Output only. The state of the pickup serving.
+    "uri": "A String", # Required. Pickup product page URI. It is only used for the review of pickup serving. This URI domain should match with the business's homepage.
+  },
+  "regionCode": "A String", # Required. Immutable. Region code defined by [CLDR](https://cldr.unicode.org/). Must be provided in the Create method, and is immutable.
+}

+

+
+

+    get(name, x__xgafv=None)
+  
Get the omnichannel settings for a given merchant.
+
+Args:
+  name: string, Required. The name of the omnichannel setting to retrieve. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Collection of information related to the omnichannel settings of a merchant.
+  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+    "state": "A String", # Output only. The state of the URI.
+    "uri": "A String", # Required. The about page URI.
+  },
+  "inStock": { # Collection of information related to InStock. # Optional. The InStock URI and state for this country.
+    "state": "A String", # Output only. The state of the in-stock serving.
+    "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
+  },
+  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+    "contact": "A String", # Required. The name of the contact for the inventory verification process.
+    "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
+    "contactState": "A String", # Output only. The state of the contact verification.
+    "state": "A String", # Output only. The state of the inventory verification process.
+  },
+  "lfpLink": { # Collection of information related to the LFP link. # Output only. The established link to a LFP provider.
+    "externalAccountId": "A String", # Required. The account ID by which this merchant is known to the LFP provider.
+    "lfpProvider": "A String", # Required. The resource name of the LFP provider. Format: `lfpProviders/{lfp_provider}`
+    "state": "A String", # Output only. The state of the LFP link.
+  },
+  "lsfType": "A String", # Required. The Local Store Front type for this country.
+  "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
+  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+    "state": "A String", # Output only. The state of the URI.
+    "uri": "A String", # Required. The on display to order (ODO) policy URI.
+  },
+  "pickup": { # Collection of information related to Pickup. # Optional. The Pickup URI and state for this country.
+    "state": "A String", # Output only. The state of the pickup serving.
+    "uri": "A String", # Required. Pickup product page URI. It is only used for the review of pickup serving. This URI domain should match with the business's homepage.
+  },
+  "regionCode": "A String", # Required. Immutable. Region code defined by [CLDR](https://cldr.unicode.org/). Must be provided in the Create method, and is immutable.
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
List all the omnichannel settings for a given merchant.
+
+Args:
+  parent: string, Required. The parent, which owns this collection of omnichannel settings. Format: `accounts/{account}` (required)
+  pageSize: integer, Optional. The maximum number of omnichannel settings to return. The service may return fewer than this value. If unspecified, at most 50 omnichannel settings 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 `ListOmnichannelSettings` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListOmnichannelSettings` 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 the ListOmnichannelSettings method.
+  "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.
+  "omnichannelSettings": [ # The omnichannel settings from the specified merchant.
+    { # Collection of information related to the omnichannel settings of a merchant.
+      "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+        "state": "A String", # Output only. The state of the URI.
+        "uri": "A String", # Required. The about page URI.
+      },
+      "inStock": { # Collection of information related to InStock. # Optional. The InStock URI and state for this country.
+        "state": "A String", # Output only. The state of the in-stock serving.
+        "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
+      },
+      "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+        "contact": "A String", # Required. The name of the contact for the inventory verification process.
+        "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
+        "contactState": "A String", # Output only. The state of the contact verification.
+        "state": "A String", # Output only. The state of the inventory verification process.
+      },
+      "lfpLink": { # Collection of information related to the LFP link. # Output only. The established link to a LFP provider.
+        "externalAccountId": "A String", # Required. The account ID by which this merchant is known to the LFP provider.
+        "lfpProvider": "A String", # Required. The resource name of the LFP provider. Format: `lfpProviders/{lfp_provider}`
+        "state": "A String", # Output only. The state of the LFP link.
+      },
+      "lsfType": "A String", # Required. The Local Store Front type for this country.
+      "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
+      "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+        "state": "A String", # Output only. The state of the URI.
+        "uri": "A String", # Required. The on display to order (ODO) policy URI.
+      },
+      "pickup": { # Collection of information related to Pickup. # Optional. The Pickup URI and state for this country.
+        "state": "A String", # Output only. The state of the pickup serving.
+        "uri": "A String", # Required. Pickup product page URI. It is only used for the review of pickup serving. This URI domain should match with the business's homepage.
+      },
+      "regionCode": "A String", # Required. Immutable. Region code defined by [CLDR](https://cldr.unicode.org/). Must be provided in the Create method, and is immutable.
+    },
+  ],
+}

+

+
+

+    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)
+  
Update the omnichannel setting for a given merchant in a given country.
+
+Args:
+  name: string, Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Collection of information related to the omnichannel settings of a merchant.
+  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+    "state": "A String", # Output only. The state of the URI.
+    "uri": "A String", # Required. The about page URI.
+  },
+  "inStock": { # Collection of information related to InStock. # Optional. The InStock URI and state for this country.
+    "state": "A String", # Output only. The state of the in-stock serving.
+    "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
+  },
+  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+    "contact": "A String", # Required. The name of the contact for the inventory verification process.
+    "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
+    "contactState": "A String", # Output only. The state of the contact verification.
+    "state": "A String", # Output only. The state of the inventory verification process.
+  },
+  "lfpLink": { # Collection of information related to the LFP link. # Output only. The established link to a LFP provider.
+    "externalAccountId": "A String", # Required. The account ID by which this merchant is known to the LFP provider.
+    "lfpProvider": "A String", # Required. The resource name of the LFP provider. Format: `lfpProviders/{lfp_provider}`
+    "state": "A String", # Output only. The state of the LFP link.
+  },
+  "lsfType": "A String", # Required. The Local Store Front type for this country.
+  "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
+  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+    "state": "A String", # Output only. The state of the URI.
+    "uri": "A String", # Required. The on display to order (ODO) policy URI.
+  },
+  "pickup": { # Collection of information related to Pickup. # Optional. The Pickup URI and state for this country.
+    "state": "A String", # Output only. The state of the pickup serving.
+    "uri": "A String", # Required. Pickup product page URI. It is only used for the review of pickup serving. This URI domain should match with the business's homepage.
+  },
+  "regionCode": "A String", # Required. Immutable. Region code defined by [CLDR](https://cldr.unicode.org/). Must be provided in the Create method, and is immutable.
+}
+
+  updateMask: string, Required. The list of fields to be updated. The following fields are supported in snake_case only: - `lsf_type` - `in_stock` - `pickup` - `odo` - `about` - `inventory_verification` Full replacement with wildcard `*`is supported, while empty/implied update mask is not.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Collection of information related to the omnichannel settings of a merchant.
+  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+    "state": "A String", # Output only. The state of the URI.
+    "uri": "A String", # Required. The about page URI.
+  },
+  "inStock": { # Collection of information related to InStock. # Optional. The InStock URI and state for this country.
+    "state": "A String", # Output only. The state of the in-stock serving.
+    "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
+  },
+  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+    "contact": "A String", # Required. The name of the contact for the inventory verification process.
+    "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
+    "contactState": "A String", # Output only. The state of the contact verification.
+    "state": "A String", # Output only. The state of the inventory verification process.
+  },
+  "lfpLink": { # Collection of information related to the LFP link. # Output only. The established link to a LFP provider.
+    "externalAccountId": "A String", # Required. The account ID by which this merchant is known to the LFP provider.
+    "lfpProvider": "A String", # Required. The resource name of the LFP provider. Format: `lfpProviders/{lfp_provider}`
+    "state": "A String", # Output only. The state of the LFP link.
+  },
+  "lsfType": "A String", # Required. The Local Store Front type for this country.
+  "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
+  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+    "state": "A String", # Output only. The state of the URI.
+    "uri": "A String", # Required. The on display to order (ODO) policy URI.
+  },
+  "pickup": { # Collection of information related to Pickup. # Optional. The Pickup URI and state for this country.
+    "state": "A String", # Output only. The state of the pickup serving.
+    "uri": "A String", # Required. Pickup product page URI. It is only used for the review of pickup serving. This URI domain should match with the business's homepage.
+  },
+  "regionCode": "A String", # Required. Immutable. Region code defined by [CLDR](https://cldr.unicode.org/). Must be provided in the Create method, and is immutable.
+}

+

+
+

+    requestInventoryVerification(name, body=None, x__xgafv=None)
+  
Requests inventory verification for a given merchant in a given country.
+
+Args:
+  name: string, Required. The name of the omnichannel setting to request inventory verification. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the RequestInventoryVerification method.
+}
+
+  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 RequestInventoryVerification method.
+  "omnichannelSetting": { # Collection of information related to the omnichannel settings of a merchant. # The omnichannel setting that was updated.
+    "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+      "state": "A String", # Output only. The state of the URI.
+      "uri": "A String", # Required. The about page URI.
+    },
+    "inStock": { # Collection of information related to InStock. # Optional. The InStock URI and state for this country.
+      "state": "A String", # Output only. The state of the in-stock serving.
+      "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
+    },
+    "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+      "contact": "A String", # Required. The name of the contact for the inventory verification process.
+      "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
+      "contactState": "A String", # Output only. The state of the contact verification.
+      "state": "A String", # Output only. The state of the inventory verification process.
+    },
+    "lfpLink": { # Collection of information related to the LFP link. # Output only. The established link to a LFP provider.
+      "externalAccountId": "A String", # Required. The account ID by which this merchant is known to the LFP provider.
+      "lfpProvider": "A String", # Required. The resource name of the LFP provider. Format: `lfpProviders/{lfp_provider}`
+      "state": "A String", # Output only. The state of the LFP link.
+    },
+    "lsfType": "A String", # Required. The Local Store Front type for this country.
+    "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
+    "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+      "state": "A String", # Output only. The state of the URI.
+      "uri": "A String", # Required. The on display to order (ODO) policy URI.
+    },
+    "pickup": { # Collection of information related to Pickup. # Optional. The Pickup URI and state for this country.
+      "state": "A String", # Output only. The state of the pickup serving.
+      "uri": "A String", # Required. Pickup product page URI. It is only used for the review of pickup serving. This URI domain should match with the business's homepage.
+    },
+    "regionCode": "A String", # Required. Immutable. Region code defined by [CLDR](https://cldr.unicode.org/). Must be provided in the Create method, and is immutable.
+  },
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.lfpProviders.html b/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.lfpProviders.html
new file mode 100644
index 00000000000..f721ad4cd7b
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.omnichannelSettings.lfpProviders.html
@@ -0,0 +1,164 @@
+
+
+
+
Merchant API . accounts . omnichannelSettings . lfpProviders

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Find the LFP provider candidates in a given country.

+

+  find_next()

+
Retrieves the next page of results.

+

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

+
Link the specified merchant to a LFP provider for the specified country.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    find(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Find the LFP provider candidates in a given country.
+
+Args:
+  parent: string, Required. The name of the parent resource under which the LFP providers are found. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`. (required)
+  pageSize: integer, Optional. The maximum number of `LfpProvider` resources to return. The service returns fewer than this value if the number of lfp providers is less that than the `pageSize`. The default value is 50. The maximum value is 1000; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum.
+  pageToken: string, Optional. A page token, received from a previous `FindLfpProviders` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `FindLfpProviders` 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 the FindLfpProviders method.
+  "lfpProviders": [ # The LFP providers from the specified merchant in the specified country.
+    { # Collection of information related to a Local Feed Partnership (LFP) provider.
+      "displayName": "A String", # The display name of the LFP provider.
+      "name": "A String", # Identifier. The resource name of the LFP provider. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}`
+      "regionCode": "A String", # Output only. Region code defined by [CLDR](https://cldr.unicode.org/).
+    },
+  ],
+  "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.
+}

+

+
+

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

+

+
+

+    linkLfpProvider(name, body=None, x__xgafv=None)
+  
Link the specified merchant to a LFP provider for the specified country.
+
+Args:
+  name: string, Required. The name of the LFP provider resource to link. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}`. The `lfp_provider` is the LFP provider ID. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the LinkLfpProvider method.
+  "externalAccountId": "A String", # Required. The external account ID by which this merchant is known to the LFP provider.
+}
+
+  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 LinkLfpProvider method.
+  "response": { # 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); } # Empty response.
+  },
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.onlineReturnPolicies.html b/docs/dyn/merchantapi_accounts_v1.accounts.onlineReturnPolicies.html
new file mode 100644
index 00000000000..2ea0e319a04
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.onlineReturnPolicies.html
@@ -0,0 +1,424 @@
+
+
+
+
Merchant API . accounts . onlineReturnPolicies

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Creates a new return policy for a given business.

+

+  delete(name, x__xgafv=None)

+
Deletes an existing return policy.

+

+  get(name, x__xgafv=None)

+
Gets an existing return policy for a given business.

+

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

+
Lists all existing return policies for a given business.

+

+  list_next()

+
Retrieves the next page of results.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, x__xgafv=None)
+  
Creates a new return policy for a given business.
+
+Args:
+  parent: string, Required. The Merchant Center account for which the return policy will be created. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # [Online return policy](https://support.google.com/merchants/answer/10220642) object. This is currently used to represent return policies for ads and free listings programs.
+  "acceptDefectiveOnly": True or False, # Optional. This field specifies if business only accepts defective products for returns.
+  "acceptExchange": True or False, # Optional. This field specifies if business allows customers to exchange products.
+  "countries": [ # Required. Immutable. The countries of sale where the return policy applies. The values must be a valid 2 letter ISO 3166 code.
+    "A String",
+  ],
+  "itemConditions": [ # Optional. The item conditions accepted for returns must not be empty unless the type of return policy is 'noReturns'.
+    "A String",
+  ],
+  "label": "A String", # Optional. Immutable. This field represents the unique user-defined label of the return policy for the given country. It is important to note that the same label cannot be used in different return policies for the same country. If not given, policies will be automatically treated as the 'default' for the country. When using label, you are creating an exception policy in that country to assign a custom return policy to certain product groups, follow the instructions provided in the [Return policy label] (https://support.google.com/merchants/answer/9445425). The label can contain up to 50 characters.
+  "name": "A String", # Identifier. The name of the `OnlineReturnPolicy` resource. Format: `accounts/{account}/onlineReturnPolicies/{return_policy}`
+  "policy": { # The available policies. # Optional. The return policy.
+    "days": "A String", # The number of days items can be returned after delivery, where one day is defined as 24 hours after the delivery timestamp. Required for `NUMBER_OF_DAYS_AFTER_DELIVERY` returns.
+    "type": "A String", # Policy type.
+  },
+  "processRefundDays": 42, # Optional. The field specifies the number of days it takes for business to process refunds.
+  "restockingFee": { # The restocking fee. This can be a flat fee or a micro percent. # Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set.
+    "fixedFee": { # The price represented as a number and currency. # Fixed restocking fee.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "microPercent": 42, # Percent of total price in micros. 15,000,000 means 15% of the total price would be charged.
+  },
+  "returnLabelSource": "A String", # Optional. The field specifies the return label source.
+  "returnMethods": [ # Optional. The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns.
+    "A String",
+  ],
+  "returnPolicyId": "A String", # Output only. Return policy ID generated by Google.
+  "returnPolicyUri": "A String", # Required. The return policy uri. This can used by Google to do a sanity check for the policy. It must be a valid URL.
+  "returnShippingFee": { # The return shipping fee. This can either be a fixed fee or a boolean to indicate that the customer pays the actual shipping cost. # Optional. The return shipping fee. Should be set only when customer need to download and print the return label.
+    "fixedFee": { # The price represented as a number and currency. # Fixed return shipping fee amount. This value is only applicable when type is `FIXED`. We will treat the return shipping fee as free if type is `FIXED` and this value is not set.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "type": "A String", # Required. Type of return shipping fee.
+  },
+  "seasonalOverrides": [ # Optional. Overrides to the general policy for orders placed during a specific set of time intervals.
+    {
+      "endDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. seasonal override end date (inclusive).
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+      "label": "A String", # Required. Display name of this seasonal override in Merchant Center.
+      "returnDays": 42, # Number of days (from the delivery date) that the product can be returned.
+      "returnUntilDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Fixed end date until which the product can be returned.
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+      "startDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Defines the date range when this seasonal override applies. Both start_date and end_date are inclusive. The dates of the seasonal overrides should not overlap.
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+    },
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # [Online return policy](https://support.google.com/merchants/answer/10220642) object. This is currently used to represent return policies for ads and free listings programs.
+  "acceptDefectiveOnly": True or False, # Optional. This field specifies if business only accepts defective products for returns.
+  "acceptExchange": True or False, # Optional. This field specifies if business allows customers to exchange products.
+  "countries": [ # Required. Immutable. The countries of sale where the return policy applies. The values must be a valid 2 letter ISO 3166 code.
+    "A String",
+  ],
+  "itemConditions": [ # Optional. The item conditions accepted for returns must not be empty unless the type of return policy is 'noReturns'.
+    "A String",
+  ],
+  "label": "A String", # Optional. Immutable. This field represents the unique user-defined label of the return policy for the given country. It is important to note that the same label cannot be used in different return policies for the same country. If not given, policies will be automatically treated as the 'default' for the country. When using label, you are creating an exception policy in that country to assign a custom return policy to certain product groups, follow the instructions provided in the [Return policy label] (https://support.google.com/merchants/answer/9445425). The label can contain up to 50 characters.
+  "name": "A String", # Identifier. The name of the `OnlineReturnPolicy` resource. Format: `accounts/{account}/onlineReturnPolicies/{return_policy}`
+  "policy": { # The available policies. # Optional. The return policy.
+    "days": "A String", # The number of days items can be returned after delivery, where one day is defined as 24 hours after the delivery timestamp. Required for `NUMBER_OF_DAYS_AFTER_DELIVERY` returns.
+    "type": "A String", # Policy type.
+  },
+  "processRefundDays": 42, # Optional. The field specifies the number of days it takes for business to process refunds.
+  "restockingFee": { # The restocking fee. This can be a flat fee or a micro percent. # Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set.
+    "fixedFee": { # The price represented as a number and currency. # Fixed restocking fee.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "microPercent": 42, # Percent of total price in micros. 15,000,000 means 15% of the total price would be charged.
+  },
+  "returnLabelSource": "A String", # Optional. The field specifies the return label source.
+  "returnMethods": [ # Optional. The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns.
+    "A String",
+  ],
+  "returnPolicyId": "A String", # Output only. Return policy ID generated by Google.
+  "returnPolicyUri": "A String", # Required. The return policy uri. This can used by Google to do a sanity check for the policy. It must be a valid URL.
+  "returnShippingFee": { # The return shipping fee. This can either be a fixed fee or a boolean to indicate that the customer pays the actual shipping cost. # Optional. The return shipping fee. Should be set only when customer need to download and print the return label.
+    "fixedFee": { # The price represented as a number and currency. # Fixed return shipping fee amount. This value is only applicable when type is `FIXED`. We will treat the return shipping fee as free if type is `FIXED` and this value is not set.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "type": "A String", # Required. Type of return shipping fee.
+  },
+  "seasonalOverrides": [ # Optional. Overrides to the general policy for orders placed during a specific set of time intervals.
+    {
+      "endDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. seasonal override end date (inclusive).
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+      "label": "A String", # Required. Display name of this seasonal override in Merchant Center.
+      "returnDays": 42, # Number of days (from the delivery date) that the product can be returned.
+      "returnUntilDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Fixed end date until which the product can be returned.
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+      "startDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Defines the date range when this seasonal override applies. Both start_date and end_date are inclusive. The dates of the seasonal overrides should not overlap.
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+    },
+  ],
+}

+

+
+

+    delete(name, x__xgafv=None)
+  
Deletes an existing return policy.
+
+Args:
+  name: string, Required. The name of the return policy to delete. Format: `accounts/{account}/onlineReturnPolicies/{return_policy}` (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 an existing return policy for a given business.
+
+Args:
+  name: string, Required. The name of the return policy to retrieve. Format: `accounts/{account}/onlineReturnPolicies/{return_policy}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # [Online return policy](https://support.google.com/merchants/answer/10220642) object. This is currently used to represent return policies for ads and free listings programs.
+  "acceptDefectiveOnly": True or False, # Optional. This field specifies if business only accepts defective products for returns.
+  "acceptExchange": True or False, # Optional. This field specifies if business allows customers to exchange products.
+  "countries": [ # Required. Immutable. The countries of sale where the return policy applies. The values must be a valid 2 letter ISO 3166 code.
+    "A String",
+  ],
+  "itemConditions": [ # Optional. The item conditions accepted for returns must not be empty unless the type of return policy is 'noReturns'.
+    "A String",
+  ],
+  "label": "A String", # Optional. Immutable. This field represents the unique user-defined label of the return policy for the given country. It is important to note that the same label cannot be used in different return policies for the same country. If not given, policies will be automatically treated as the 'default' for the country. When using label, you are creating an exception policy in that country to assign a custom return policy to certain product groups, follow the instructions provided in the [Return policy label] (https://support.google.com/merchants/answer/9445425). The label can contain up to 50 characters.
+  "name": "A String", # Identifier. The name of the `OnlineReturnPolicy` resource. Format: `accounts/{account}/onlineReturnPolicies/{return_policy}`
+  "policy": { # The available policies. # Optional. The return policy.
+    "days": "A String", # The number of days items can be returned after delivery, where one day is defined as 24 hours after the delivery timestamp. Required for `NUMBER_OF_DAYS_AFTER_DELIVERY` returns.
+    "type": "A String", # Policy type.
+  },
+  "processRefundDays": 42, # Optional. The field specifies the number of days it takes for business to process refunds.
+  "restockingFee": { # The restocking fee. This can be a flat fee or a micro percent. # Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set.
+    "fixedFee": { # The price represented as a number and currency. # Fixed restocking fee.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "microPercent": 42, # Percent of total price in micros. 15,000,000 means 15% of the total price would be charged.
+  },
+  "returnLabelSource": "A String", # Optional. The field specifies the return label source.
+  "returnMethods": [ # Optional. The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns.
+    "A String",
+  ],
+  "returnPolicyId": "A String", # Output only. Return policy ID generated by Google.
+  "returnPolicyUri": "A String", # Required. The return policy uri. This can used by Google to do a sanity check for the policy. It must be a valid URL.
+  "returnShippingFee": { # The return shipping fee. This can either be a fixed fee or a boolean to indicate that the customer pays the actual shipping cost. # Optional. The return shipping fee. Should be set only when customer need to download and print the return label.
+    "fixedFee": { # The price represented as a number and currency. # Fixed return shipping fee amount. This value is only applicable when type is `FIXED`. We will treat the return shipping fee as free if type is `FIXED` and this value is not set.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "type": "A String", # Required. Type of return shipping fee.
+  },
+  "seasonalOverrides": [ # Optional. Overrides to the general policy for orders placed during a specific set of time intervals.
+    {
+      "endDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. seasonal override end date (inclusive).
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+      "label": "A String", # Required. Display name of this seasonal override in Merchant Center.
+      "returnDays": 42, # Number of days (from the delivery date) that the product can be returned.
+      "returnUntilDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Fixed end date until which the product can be returned.
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+      "startDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Defines the date range when this seasonal override applies. Both start_date and end_date are inclusive. The dates of the seasonal overrides should not overlap.
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+    },
+  ],
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists all existing return policies for a given business.
+
+Args:
+  parent: string, Required. The Merchant Center account for which to list return policies. Format: `accounts/{account}` (required)
+  pageSize: integer, Optional. The maximum number of `OnlineReturnPolicy` resources to return. The service returns fewer than this value if the number of return policies for the given business is less that than the `pageSize`. The default value is 10. The maximum value is 100; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum
+  pageToken: string, Optional. A page token, received from a previous `ListOnlineReturnPolicies` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `ListOnlineReturnPolicies` must match the call that provided the page token. The token returned as nextPageToken in the response to the previous request.
+  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 `ListOnlineReturnPolicies` method.
+  "nextPageToken": "A String", # A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "onlineReturnPolicies": [ # The retrieved return policies.
+    { # [Online return policy](https://support.google.com/merchants/answer/10220642) object. This is currently used to represent return policies for ads and free listings programs.
+      "acceptDefectiveOnly": True or False, # Optional. This field specifies if business only accepts defective products for returns.
+      "acceptExchange": True or False, # Optional. This field specifies if business allows customers to exchange products.
+      "countries": [ # Required. Immutable. The countries of sale where the return policy applies. The values must be a valid 2 letter ISO 3166 code.
+        "A String",
+      ],
+      "itemConditions": [ # Optional. The item conditions accepted for returns must not be empty unless the type of return policy is 'noReturns'.
+        "A String",
+      ],
+      "label": "A String", # Optional. Immutable. This field represents the unique user-defined label of the return policy for the given country. It is important to note that the same label cannot be used in different return policies for the same country. If not given, policies will be automatically treated as the 'default' for the country. When using label, you are creating an exception policy in that country to assign a custom return policy to certain product groups, follow the instructions provided in the [Return policy label] (https://support.google.com/merchants/answer/9445425). The label can contain up to 50 characters.
+      "name": "A String", # Identifier. The name of the `OnlineReturnPolicy` resource. Format: `accounts/{account}/onlineReturnPolicies/{return_policy}`
+      "policy": { # The available policies. # Optional. The return policy.
+        "days": "A String", # The number of days items can be returned after delivery, where one day is defined as 24 hours after the delivery timestamp. Required for `NUMBER_OF_DAYS_AFTER_DELIVERY` returns.
+        "type": "A String", # Policy type.
+      },
+      "processRefundDays": 42, # Optional. The field specifies the number of days it takes for business to process refunds.
+      "restockingFee": { # The restocking fee. This can be a flat fee or a micro percent. # Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set.
+        "fixedFee": { # The price represented as a number and currency. # Fixed restocking fee.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "microPercent": 42, # Percent of total price in micros. 15,000,000 means 15% of the total price would be charged.
+      },
+      "returnLabelSource": "A String", # Optional. The field specifies the return label source.
+      "returnMethods": [ # Optional. The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns.
+        "A String",
+      ],
+      "returnPolicyId": "A String", # Output only. Return policy ID generated by Google.
+      "returnPolicyUri": "A String", # Required. The return policy uri. This can used by Google to do a sanity check for the policy. It must be a valid URL.
+      "returnShippingFee": { # The return shipping fee. This can either be a fixed fee or a boolean to indicate that the customer pays the actual shipping cost. # Optional. The return shipping fee. Should be set only when customer need to download and print the return label.
+        "fixedFee": { # The price represented as a number and currency. # Fixed return shipping fee amount. This value is only applicable when type is `FIXED`. We will treat the return shipping fee as free if type is `FIXED` and this value is not set.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "type": "A String", # Required. Type of return shipping fee.
+      },
+      "seasonalOverrides": [ # Optional. Overrides to the general policy for orders placed during a specific set of time intervals.
+        {
+          "endDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. seasonal override end date (inclusive).
+            "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+            "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+            "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+          },
+          "label": "A String", # Required. Display name of this seasonal override in Merchant Center.
+          "returnDays": 42, # Number of days (from the delivery date) that the product can be returned.
+          "returnUntilDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Fixed end date until which the product can be returned.
+            "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+            "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+            "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+          },
+          "startDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Defines the date range when this seasonal override applies. Both start_date and end_date are inclusive. The dates of the seasonal overrides should not overlap.
+            "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+            "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+            "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+          },
+        },
+      ],
+    },
+  ],
+}

+

+
+

+    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/merchantapi_accounts_v1.accounts.programs.checkoutSettings.html b/docs/dyn/merchantapi_accounts_v1.accounts.programs.checkoutSettings.html
new file mode 100644
index 00000000000..93e66456e84
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.programs.checkoutSettings.html
@@ -0,0 +1,263 @@
+
+
+
+
Merchant API . accounts . programs . checkoutSettings

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Creates `CheckoutSettings` for the given merchant.

+

+  deleteCheckoutSettings(name, x__xgafv=None)

+
Deletes `CheckoutSettings` and unenrolls merchant from `Checkout` program.

+

+  getCheckoutSettings(name, x__xgafv=None)

+
Gets `CheckoutSettings` for the given merchant. This includes information about review state, enrollment state and URL settings.

+

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

+
Updates `CheckoutSettings` for the given merchant.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, x__xgafv=None)
+  
Creates `CheckoutSettings` for the given merchant.
+
+Args:
+  parent: string, Required. The merchant account for which the `CheckoutSettings` will be created. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # [CheckoutSettings](https://support.google.com/merchants/answer/13945960) for a specific merchant.
+  "effectiveEnrollmentState": "A String", # Output only. The effective value of enrollment_state for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+  "effectiveReviewState": "A String", # Output only. The effective value of `review_state` for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+  "effectiveUriSettings": { # URL settings for cart or checkout URL. # Output only. The effective value of `uri_settings` for a given merchant. If account level settings are present then this value will be a copy of url settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+    "cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+    "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+  },
+  "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`
+    "A String",
+  ],
+  "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program.
+  "name": "A String", # Identifier. The resource name of the program configuration settings. Format: `accounts/{account}/programs/{program}/checkoutSettings`
+  "reviewState": "A String", # Output only. Reflects the merchant review state in `Checkout` program. This is set based on the data quality reviews of the URL provided by the merchant. A merchant with enrollment state as `ENROLLED` can be in the following review states: `IN_REVIEW`, `APPROVED` or `DISAPPROVED`. A merchant must be in an `enrollment_state` of `ENROLLED` before a review can begin for the merchant.For more details, check the help center doc.
+  "uriSettings": { # URL settings for cart or checkout URL. # URI settings for cart or checkout URL.
+    "cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+    "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # [CheckoutSettings](https://support.google.com/merchants/answer/13945960) for a specific merchant.
+  "effectiveEnrollmentState": "A String", # Output only. The effective value of enrollment_state for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+  "effectiveReviewState": "A String", # Output only. The effective value of `review_state` for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+  "effectiveUriSettings": { # URL settings for cart or checkout URL. # Output only. The effective value of `uri_settings` for a given merchant. If account level settings are present then this value will be a copy of url settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+    "cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+    "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+  },
+  "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`
+    "A String",
+  ],
+  "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program.
+  "name": "A String", # Identifier. The resource name of the program configuration settings. Format: `accounts/{account}/programs/{program}/checkoutSettings`
+  "reviewState": "A String", # Output only. Reflects the merchant review state in `Checkout` program. This is set based on the data quality reviews of the URL provided by the merchant. A merchant with enrollment state as `ENROLLED` can be in the following review states: `IN_REVIEW`, `APPROVED` or `DISAPPROVED`. A merchant must be in an `enrollment_state` of `ENROLLED` before a review can begin for the merchant.For more details, check the help center doc.
+  "uriSettings": { # URL settings for cart or checkout URL. # URI settings for cart or checkout URL.
+    "cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+    "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+  },
+}

+

+
+

+    deleteCheckoutSettings(name, x__xgafv=None)
+  
Deletes `CheckoutSettings` and unenrolls merchant from `Checkout` program.
+
+Args:
+  name: string, Required. The name/identifier of the merchant account. Format: `accounts/{account}/programs/{program}/checkoutSettings` (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); }
+}

+

+
+

+    getCheckoutSettings(name, x__xgafv=None)
+  
Gets `CheckoutSettings` for the given merchant. This includes information about review state, enrollment state and URL settings.
+
+Args:
+  name: string, Required. The name/identifier of the merchant account. Format: `accounts/{account}/programs/{program}/checkoutSettings` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # [CheckoutSettings](https://support.google.com/merchants/answer/13945960) for a specific merchant.
+  "effectiveEnrollmentState": "A String", # Output only. The effective value of enrollment_state for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+  "effectiveReviewState": "A String", # Output only. The effective value of `review_state` for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+  "effectiveUriSettings": { # URL settings for cart or checkout URL. # Output only. The effective value of `uri_settings` for a given merchant. If account level settings are present then this value will be a copy of url settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+    "cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+    "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+  },
+  "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`
+    "A String",
+  ],
+  "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program.
+  "name": "A String", # Identifier. The resource name of the program configuration settings. Format: `accounts/{account}/programs/{program}/checkoutSettings`
+  "reviewState": "A String", # Output only. Reflects the merchant review state in `Checkout` program. This is set based on the data quality reviews of the URL provided by the merchant. A merchant with enrollment state as `ENROLLED` can be in the following review states: `IN_REVIEW`, `APPROVED` or `DISAPPROVED`. A merchant must be in an `enrollment_state` of `ENROLLED` before a review can begin for the merchant.For more details, check the help center doc.
+  "uriSettings": { # URL settings for cart or checkout URL. # URI settings for cart or checkout URL.
+    "cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+    "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+  },
+}

+

+
+

+    updateCheckoutSettings(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates `CheckoutSettings` for the given merchant.
+
+Args:
+  name: string, Identifier. The resource name of the program configuration settings. Format: `accounts/{account}/programs/{program}/checkoutSettings` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # [CheckoutSettings](https://support.google.com/merchants/answer/13945960) for a specific merchant.
+  "effectiveEnrollmentState": "A String", # Output only. The effective value of enrollment_state for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+  "effectiveReviewState": "A String", # Output only. The effective value of `review_state` for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+  "effectiveUriSettings": { # URL settings for cart or checkout URL. # Output only. The effective value of `uri_settings` for a given merchant. If account level settings are present then this value will be a copy of url settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+    "cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+    "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+  },
+  "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`
+    "A String",
+  ],
+  "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program.
+  "name": "A String", # Identifier. The resource name of the program configuration settings. Format: `accounts/{account}/programs/{program}/checkoutSettings`
+  "reviewState": "A String", # Output only. Reflects the merchant review state in `Checkout` program. This is set based on the data quality reviews of the URL provided by the merchant. A merchant with enrollment state as `ENROLLED` can be in the following review states: `IN_REVIEW`, `APPROVED` or `DISAPPROVED`. A merchant must be in an `enrollment_state` of `ENROLLED` before a review can begin for the merchant.For more details, check the help center doc.
+  "uriSettings": { # URL settings for cart or checkout URL. # URI settings for cart or checkout URL.
+    "cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+    "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+  },
+}
+
+  updateMask: string, Required. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `eligible_destinations` - `uri_settings`
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # [CheckoutSettings](https://support.google.com/merchants/answer/13945960) for a specific merchant.
+  "effectiveEnrollmentState": "A String", # Output only. The effective value of enrollment_state for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+  "effectiveReviewState": "A String", # Output only. The effective value of `review_state` for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+  "effectiveUriSettings": { # URL settings for cart or checkout URL. # Output only. The effective value of `uri_settings` for a given merchant. If account level settings are present then this value will be a copy of url settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).
+    "cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+    "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+  },
+  "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`
+    "A String",
+  ],
+  "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program.
+  "name": "A String", # Identifier. The resource name of the program configuration settings. Format: `accounts/{account}/programs/{program}/checkoutSettings`
+  "reviewState": "A String", # Output only. Reflects the merchant review state in `Checkout` program. This is set based on the data quality reviews of the URL provided by the merchant. A merchant with enrollment state as `ENROLLED` can be in the following review states: `IN_REVIEW`, `APPROVED` or `DISAPPROVED`. A merchant must be in an `enrollment_state` of `ENROLLED` before a review can begin for the merchant.For more details, check the help center doc.
+  "uriSettings": { # URL settings for cart or checkout URL. # URI settings for cart or checkout URL.
+    "cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+    "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)
+  },
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.programs.html b/docs/dyn/merchantapi_accounts_v1.accounts.programs.html
new file mode 100644
index 00000000000..dc9994479ca
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.programs.html
@@ -0,0 +1,271 @@
+
+
+
+
Merchant API . accounts . programs

+
Instance Methods

+

+  checkoutSettings()
+

+
Returns the checkoutSettings Resource.

+
+

+  close()

+
Close httplib2 connections.

+

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

+
Disable participation in the specified program for the account.

+

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

+
Enable participation in the specified program for the account.

+

+  get(name, x__xgafv=None)

+
Retrieves the specified program for the account.

+

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

+
Retrieves all programs for the account.

+

+  list_next()

+
Retrieves the next page of results.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    disable(name, body=None, x__xgafv=None)
+  
Disable participation in the specified program for the account.
+
+Args:
+  name: string, Required. The name of the program for which to disable participation for the given account. Format: `accounts/{account}/programs/{program}`. For example, `accounts/123456/programs/free-listings`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the DisableProgram method.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`
+  "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally.
+    "A String",
+  ],
+  "documentationUri": "A String", # Output only. The URL of a Merchant Center help page describing the program.
+  "name": "A String", # Identifier. The resource name of the program. Format: `accounts/{account}/programs/{program}`
+  "state": "A String", # Output only. The participation state of the account in the program.
+  "unmetRequirements": [ # Output only. The requirements that the account has not yet satisfied that are affecting participation in the program.
+    { # Defines a requirement specified for participation in the program.
+      "affectedRegionCodes": [ # Output only. The regions that are currently affected by this requirement not being met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally.
+        "A String",
+      ],
+      "documentationUri": "A String", # Output only. The URL of a help page describing the requirement.
+      "title": "A String", # Output only. Name of the requirement.
+    },
+  ],
+}

+

+
+

+    enable(name, body=None, x__xgafv=None)
+  
Enable participation in the specified program for the account.
+
+Args:
+  name: string, Required. The name of the program for which to enable participation for the given account. Format: `accounts/{account}/programs/{program}`. For example, `accounts/123456/programs/free-listings`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the EnableProgram method.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`
+  "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally.
+    "A String",
+  ],
+  "documentationUri": "A String", # Output only. The URL of a Merchant Center help page describing the program.
+  "name": "A String", # Identifier. The resource name of the program. Format: `accounts/{account}/programs/{program}`
+  "state": "A String", # Output only. The participation state of the account in the program.
+  "unmetRequirements": [ # Output only. The requirements that the account has not yet satisfied that are affecting participation in the program.
+    { # Defines a requirement specified for participation in the program.
+      "affectedRegionCodes": [ # Output only. The regions that are currently affected by this requirement not being met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally.
+        "A String",
+      ],
+      "documentationUri": "A String", # Output only. The URL of a help page describing the requirement.
+      "title": "A String", # Output only. Name of the requirement.
+    },
+  ],
+}

+

+
+

+    get(name, x__xgafv=None)
+  
Retrieves the specified program for the account.
+
+Args:
+  name: string, Required. The name of the program to retrieve. Format: `accounts/{account}/programs/{program}`. For example, `accounts/123456/programs/free-listings`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`
+  "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally.
+    "A String",
+  ],
+  "documentationUri": "A String", # Output only. The URL of a Merchant Center help page describing the program.
+  "name": "A String", # Identifier. The resource name of the program. Format: `accounts/{account}/programs/{program}`
+  "state": "A String", # Output only. The participation state of the account in the program.
+  "unmetRequirements": [ # Output only. The requirements that the account has not yet satisfied that are affecting participation in the program.
+    { # Defines a requirement specified for participation in the program.
+      "affectedRegionCodes": [ # Output only. The regions that are currently affected by this requirement not being met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally.
+        "A String",
+      ],
+      "documentationUri": "A String", # Output only. The URL of a help page describing the requirement.
+      "title": "A String", # Output only. Name of the requirement.
+    },
+  ],
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Retrieves all programs for the account.
+
+Args:
+  parent: string, Required. The name of the account for which to retrieve all programs. Format: `accounts/{account}` (required)
+  pageSize: integer, Optional. The maximum number of programs to return in a single response. If unspecified (or 0), a default size of 1000 is used. The maximum value is 1000; values above 1000 will be coerced to 1000.
+  pageToken: string, Optional. A continuation token, received from a previous `ListPrograms` call. Provide this to retrieve the next page.
+  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 ListPrograms method.
+  "nextPageToken": "A String", # A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "programs": [ # The programs for the given account.
+    { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`
+      "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally.
+        "A String",
+      ],
+      "documentationUri": "A String", # Output only. The URL of a Merchant Center help page describing the program.
+      "name": "A String", # Identifier. The resource name of the program. Format: `accounts/{account}/programs/{program}`
+      "state": "A String", # Output only. The participation state of the account in the program.
+      "unmetRequirements": [ # Output only. The requirements that the account has not yet satisfied that are affecting participation in the program.
+        { # Defines a requirement specified for participation in the program.
+          "affectedRegionCodes": [ # Output only. The regions that are currently affected by this requirement not being met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally.
+            "A String",
+          ],
+          "documentationUri": "A String", # Output only. The URL of a help page describing the requirement.
+          "title": "A String", # Output only. Name of the requirement.
+        },
+      ],
+    },
+  ],
+}

+

+
+

+    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/merchantapi_accounts_v1.accounts.regions.html b/docs/dyn/merchantapi_accounts_v1.accounts.regions.html
new file mode 100644
index 00000000000..8dd731ffe7f
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.regions.html
@@ -0,0 +1,337 @@
+
+
+
+
Merchant API . accounts . regions

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Creates a region definition in your Merchant Center account. Executing this method requires admin access.

+

+  delete(name, x__xgafv=None)

+
Deletes a region definition from your Merchant Center account. Executing this method requires admin access.

+

+  get(name, x__xgafv=None)

+
Retrieves a region defined in your Merchant Center account.

+

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

+
Lists the regions in your Merchant Center account.

+

+  list_next()

+
Retrieves the next page of results.

+

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

+
Updates a region definition in your Merchant Center account. Executing this method requires admin access.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, regionId=None, x__xgafv=None)
+  
Creates a region definition in your Merchant Center account. Executing this method requires admin access.
+
+Args:
+  parent: string, Required. The account to create a region for. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a geographic region that you can use as a target with both the `RegionalInventory` and `ShippingSettings` services. You can define regions as collections of either postal codes or, in some countries, using predefined geotargets. For more information, see [Set up regions ](https://support.google.com/merchants/answer/7410946#zippy=%2Ccreate-a-new-region) for more information.
+  "displayName": "A String", # Optional. The display name of the region.
+  "geotargetArea": { # A list of geotargets that defines the region area. # Optional. A list of geotargets that defines the region area.
+    "geotargetCriteriaIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (for example, state).
+      "A String",
+    ],
+  },
+  "name": "A String", # Identifier. The resource name of the region. Format: `accounts/{account}/regions/{region}`
+  "postalCodeArea": { # A list of postal codes that defines the region area. Note: All regions defined using postal codes are accessible through the account's `ShippingSettings.postalCodeGroups` resource. # Optional. A list of postal codes that defines the region area.
+    "postalCodes": [ # Required. A range of postal codes.
+      { # A range of postal codes that defines the region area.
+        "begin": "A String", # Required. A postal code or a pattern of the form prefix* denoting the inclusive lower bound of the range defining the area. Examples values: `94108`, `9410*`, `9*`.
+        "end": "A String", # Optional. A postal code or a pattern of the form `prefix*` denoting the inclusive upper bound of the range defining the area. It must have the same length as postalCodeRangeBegin: if postalCodeRangeBegin is a postal code then postalCodeRangeEnd must be a postal code too; if postalCodeRangeBegin is a pattern then postalCodeRangeEnd must be a pattern with the same prefix length. Optional: if not set, then the area is defined as being all the postal codes matching postalCodeRangeBegin.
+      },
+    ],
+    "regionCode": "A String", # Required. [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) or the country the postal code group applies to.
+  },
+  "regionalInventoryEligible": True or False, # Output only. Indicates if the region is eligible for use in the Regional Inventory configuration.
+  "shippingEligible": True or False, # Output only. Indicates if the region is eligible for use in the Shipping Services configuration.
+}
+
+  regionId: string, Required. The identifier for the region, unique over all regions of the same account.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a geographic region that you can use as a target with both the `RegionalInventory` and `ShippingSettings` services. You can define regions as collections of either postal codes or, in some countries, using predefined geotargets. For more information, see [Set up regions ](https://support.google.com/merchants/answer/7410946#zippy=%2Ccreate-a-new-region) for more information.
+  "displayName": "A String", # Optional. The display name of the region.
+  "geotargetArea": { # A list of geotargets that defines the region area. # Optional. A list of geotargets that defines the region area.
+    "geotargetCriteriaIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (for example, state).
+      "A String",
+    ],
+  },
+  "name": "A String", # Identifier. The resource name of the region. Format: `accounts/{account}/regions/{region}`
+  "postalCodeArea": { # A list of postal codes that defines the region area. Note: All regions defined using postal codes are accessible through the account's `ShippingSettings.postalCodeGroups` resource. # Optional. A list of postal codes that defines the region area.
+    "postalCodes": [ # Required. A range of postal codes.
+      { # A range of postal codes that defines the region area.
+        "begin": "A String", # Required. A postal code or a pattern of the form prefix* denoting the inclusive lower bound of the range defining the area. Examples values: `94108`, `9410*`, `9*`.
+        "end": "A String", # Optional. A postal code or a pattern of the form `prefix*` denoting the inclusive upper bound of the range defining the area. It must have the same length as postalCodeRangeBegin: if postalCodeRangeBegin is a postal code then postalCodeRangeEnd must be a postal code too; if postalCodeRangeBegin is a pattern then postalCodeRangeEnd must be a pattern with the same prefix length. Optional: if not set, then the area is defined as being all the postal codes matching postalCodeRangeBegin.
+      },
+    ],
+    "regionCode": "A String", # Required. [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) or the country the postal code group applies to.
+  },
+  "regionalInventoryEligible": True or False, # Output only. Indicates if the region is eligible for use in the Regional Inventory configuration.
+  "shippingEligible": True or False, # Output only. Indicates if the region is eligible for use in the Shipping Services configuration.
+}

+

+
+

+    delete(name, x__xgafv=None)
+  
Deletes a region definition from your Merchant Center account. Executing this method requires admin access.
+
+Args:
+  name: string, Required. The name of the region to delete. Format: `accounts/{account}/regions/{region}` (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)
+  
Retrieves a region defined in your Merchant Center account.
+
+Args:
+  name: string, Required. The name of the region to retrieve. Format: `accounts/{account}/regions/{region}` (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 geographic region that you can use as a target with both the `RegionalInventory` and `ShippingSettings` services. You can define regions as collections of either postal codes or, in some countries, using predefined geotargets. For more information, see [Set up regions ](https://support.google.com/merchants/answer/7410946#zippy=%2Ccreate-a-new-region) for more information.
+  "displayName": "A String", # Optional. The display name of the region.
+  "geotargetArea": { # A list of geotargets that defines the region area. # Optional. A list of geotargets that defines the region area.
+    "geotargetCriteriaIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (for example, state).
+      "A String",
+    ],
+  },
+  "name": "A String", # Identifier. The resource name of the region. Format: `accounts/{account}/regions/{region}`
+  "postalCodeArea": { # A list of postal codes that defines the region area. Note: All regions defined using postal codes are accessible through the account's `ShippingSettings.postalCodeGroups` resource. # Optional. A list of postal codes that defines the region area.
+    "postalCodes": [ # Required. A range of postal codes.
+      { # A range of postal codes that defines the region area.
+        "begin": "A String", # Required. A postal code or a pattern of the form prefix* denoting the inclusive lower bound of the range defining the area. Examples values: `94108`, `9410*`, `9*`.
+        "end": "A String", # Optional. A postal code or a pattern of the form `prefix*` denoting the inclusive upper bound of the range defining the area. It must have the same length as postalCodeRangeBegin: if postalCodeRangeBegin is a postal code then postalCodeRangeEnd must be a postal code too; if postalCodeRangeBegin is a pattern then postalCodeRangeEnd must be a pattern with the same prefix length. Optional: if not set, then the area is defined as being all the postal codes matching postalCodeRangeBegin.
+      },
+    ],
+    "regionCode": "A String", # Required. [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) or the country the postal code group applies to.
+  },
+  "regionalInventoryEligible": True or False, # Output only. Indicates if the region is eligible for use in the Regional Inventory configuration.
+  "shippingEligible": True or False, # Output only. Indicates if the region is eligible for use in the Shipping Services configuration.
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists the regions in your Merchant Center account.
+
+Args:
+  parent: string, Required. The account to list regions for. Format: `accounts/{account}` (required)
+  pageSize: integer, Optional. The maximum number of regions to return. The service may return fewer than this value. If unspecified, at most 50 regions 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 `ListRegions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListRegions` 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 the `ListRegions` method.
+  "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.
+  "regions": [ # The regions from the specified business.
+    { # Represents a geographic region that you can use as a target with both the `RegionalInventory` and `ShippingSettings` services. You can define regions as collections of either postal codes or, in some countries, using predefined geotargets. For more information, see [Set up regions ](https://support.google.com/merchants/answer/7410946#zippy=%2Ccreate-a-new-region) for more information.
+      "displayName": "A String", # Optional. The display name of the region.
+      "geotargetArea": { # A list of geotargets that defines the region area. # Optional. A list of geotargets that defines the region area.
+        "geotargetCriteriaIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (for example, state).
+          "A String",
+        ],
+      },
+      "name": "A String", # Identifier. The resource name of the region. Format: `accounts/{account}/regions/{region}`
+      "postalCodeArea": { # A list of postal codes that defines the region area. Note: All regions defined using postal codes are accessible through the account's `ShippingSettings.postalCodeGroups` resource. # Optional. A list of postal codes that defines the region area.
+        "postalCodes": [ # Required. A range of postal codes.
+          { # A range of postal codes that defines the region area.
+            "begin": "A String", # Required. A postal code or a pattern of the form prefix* denoting the inclusive lower bound of the range defining the area. Examples values: `94108`, `9410*`, `9*`.
+            "end": "A String", # Optional. A postal code or a pattern of the form `prefix*` denoting the inclusive upper bound of the range defining the area. It must have the same length as postalCodeRangeBegin: if postalCodeRangeBegin is a postal code then postalCodeRangeEnd must be a postal code too; if postalCodeRangeBegin is a pattern then postalCodeRangeEnd must be a pattern with the same prefix length. Optional: if not set, then the area is defined as being all the postal codes matching postalCodeRangeBegin.
+          },
+        ],
+        "regionCode": "A String", # Required. [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) or the country the postal code group applies to.
+      },
+      "regionalInventoryEligible": True or False, # Output only. Indicates if the region is eligible for use in the Regional Inventory configuration.
+      "shippingEligible": True or False, # Output only. Indicates if the region is eligible for use in the Shipping Services configuration.
+    },
+  ],
+}

+

+
+

+    list_next()
+  
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        

+

+
+

+    patch(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates a region definition in your Merchant Center account. Executing this method requires admin access.
+
+Args:
+  name: string, Identifier. The resource name of the region. Format: `accounts/{account}/regions/{region}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a geographic region that you can use as a target with both the `RegionalInventory` and `ShippingSettings` services. You can define regions as collections of either postal codes or, in some countries, using predefined geotargets. For more information, see [Set up regions ](https://support.google.com/merchants/answer/7410946#zippy=%2Ccreate-a-new-region) for more information.
+  "displayName": "A String", # Optional. The display name of the region.
+  "geotargetArea": { # A list of geotargets that defines the region area. # Optional. A list of geotargets that defines the region area.
+    "geotargetCriteriaIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (for example, state).
+      "A String",
+    ],
+  },
+  "name": "A String", # Identifier. The resource name of the region. Format: `accounts/{account}/regions/{region}`
+  "postalCodeArea": { # A list of postal codes that defines the region area. Note: All regions defined using postal codes are accessible through the account's `ShippingSettings.postalCodeGroups` resource. # Optional. A list of postal codes that defines the region area.
+    "postalCodes": [ # Required. A range of postal codes.
+      { # A range of postal codes that defines the region area.
+        "begin": "A String", # Required. A postal code or a pattern of the form prefix* denoting the inclusive lower bound of the range defining the area. Examples values: `94108`, `9410*`, `9*`.
+        "end": "A String", # Optional. A postal code or a pattern of the form `prefix*` denoting the inclusive upper bound of the range defining the area. It must have the same length as postalCodeRangeBegin: if postalCodeRangeBegin is a postal code then postalCodeRangeEnd must be a postal code too; if postalCodeRangeBegin is a pattern then postalCodeRangeEnd must be a pattern with the same prefix length. Optional: if not set, then the area is defined as being all the postal codes matching postalCodeRangeBegin.
+      },
+    ],
+    "regionCode": "A String", # Required. [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) or the country the postal code group applies to.
+  },
+  "regionalInventoryEligible": True or False, # Output only. Indicates if the region is eligible for use in the Regional Inventory configuration.
+  "shippingEligible": True or False, # Output only. Indicates if the region is eligible for use in the Shipping Services configuration.
+}
+
+  updateMask: string, Optional. The comma-separated field mask indicating the fields to update. Example: `"displayName,postalCodeArea.regionCode"`.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a geographic region that you can use as a target with both the `RegionalInventory` and `ShippingSettings` services. You can define regions as collections of either postal codes or, in some countries, using predefined geotargets. For more information, see [Set up regions ](https://support.google.com/merchants/answer/7410946#zippy=%2Ccreate-a-new-region) for more information.
+  "displayName": "A String", # Optional. The display name of the region.
+  "geotargetArea": { # A list of geotargets that defines the region area. # Optional. A list of geotargets that defines the region area.
+    "geotargetCriteriaIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (for example, state).
+      "A String",
+    ],
+  },
+  "name": "A String", # Identifier. The resource name of the region. Format: `accounts/{account}/regions/{region}`
+  "postalCodeArea": { # A list of postal codes that defines the region area. Note: All regions defined using postal codes are accessible through the account's `ShippingSettings.postalCodeGroups` resource. # Optional. A list of postal codes that defines the region area.
+    "postalCodes": [ # Required. A range of postal codes.
+      { # A range of postal codes that defines the region area.
+        "begin": "A String", # Required. A postal code or a pattern of the form prefix* denoting the inclusive lower bound of the range defining the area. Examples values: `94108`, `9410*`, `9*`.
+        "end": "A String", # Optional. A postal code or a pattern of the form `prefix*` denoting the inclusive upper bound of the range defining the area. It must have the same length as postalCodeRangeBegin: if postalCodeRangeBegin is a postal code then postalCodeRangeEnd must be a postal code too; if postalCodeRangeBegin is a pattern then postalCodeRangeEnd must be a pattern with the same prefix length. Optional: if not set, then the area is defined as being all the postal codes matching postalCodeRangeBegin.
+      },
+    ],
+    "regionCode": "A String", # Required. [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) or the country the postal code group applies to.
+  },
+  "regionalInventoryEligible": True or False, # Output only. Indicates if the region is eligible for use in the Regional Inventory configuration.
+  "shippingEligible": True or False, # Output only. Indicates if the region is eligible for use in the Shipping Services configuration.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.relationships.html b/docs/dyn/merchantapi_accounts_v1.accounts.relationships.html
new file mode 100644
index 00000000000..73e085d559a
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.relationships.html
@@ -0,0 +1,196 @@
+
+
+
+
Merchant API . accounts . relationships

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

+
Retrieve an account relationship.

+

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

+
List account relationships for the specified account.

+

+  list_next()

+
Retrieves the next page of results.

+

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

+
Updates the account relationship. Executing this method requires admin access.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    get(name, x__xgafv=None)
+  
Retrieve an account relationship.
+
+Args:
+  name: string, Required. The resource name of the account relationship to get. Format: `accounts/{account}/relationships/{relationship}`. For example, `accounts/123456/relationships/567890`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `AccountRelationship` message defines a formal connection between a merchant's account and a service provider's account. This relationship enables the provider to offer specific services to the business, such as product management or campaign management. It specifies the access rights and permissions to the business's data relevant to those services. Establishing an account relationship involves linking the merchant's account with a provider's account. The provider could be another Google account (like Google Ads or Google My Business) or a third-party platform (such as Shopify or WooCommerce).
+  "accountIdAlias": "A String", # Optional. An optional alias you can assign to this account relationship. This alias acts as a convenient identifier for your own reference and management. It must be unique among all your account relationships with the same provider. For example, you might use `account_id_alias` to assign a friendly name to this relationship for easier identification in your systems.
+  "name": "A String", # Identifier. The resource name of the account relationship. Format: `accounts/{account}/relationships/{relationship}`. For example, `accounts/123456/relationships/567890`.
+  "provider": "A String", # Immutable. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
+  "providerDisplayName": "A String", # Output only. The human-readable display name of the provider account.
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
List account relationships for the specified account.
+
+Args:
+  parent: string, Required. The parent account of the account relationship to filter by. Format: `accounts/{account}` (required)
+  pageSize: integer, Optional. The maximum number of elements to return in the response. Use for paging. If no `page_size` is specified, `100` is used as the default value. The maximum allowed value is `1000`.
+  pageToken: string, Optional. The token returned by the previous `list` request.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response after trying to list account relationships.
+  "accountRelationships": [ # The account relationships that match your filter.
+    { # The `AccountRelationship` message defines a formal connection between a merchant's account and a service provider's account. This relationship enables the provider to offer specific services to the business, such as product management or campaign management. It specifies the access rights and permissions to the business's data relevant to those services. Establishing an account relationship involves linking the merchant's account with a provider's account. The provider could be another Google account (like Google Ads or Google My Business) or a third-party platform (such as Shopify or WooCommerce).
+      "accountIdAlias": "A String", # Optional. An optional alias you can assign to this account relationship. This alias acts as a convenient identifier for your own reference and management. It must be unique among all your account relationships with the same provider. For example, you might use `account_id_alias` to assign a friendly name to this relationship for easier identification in your systems.
+      "name": "A String", # Identifier. The resource name of the account relationship. Format: `accounts/{account}/relationships/{relationship}`. For example, `accounts/123456/relationships/567890`.
+      "provider": "A String", # Immutable. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
+      "providerDisplayName": "A String", # Output only. The human-readable display name of the provider account.
+    },
+  ],
+  "nextPageToken": "A String", # A page token. You can send the `page_token` to get the next page. Only included in the `list` response if there are more pages.
+}

+

+
+

+    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 account relationship. Executing this method requires admin access.
+
+Args:
+  name: string, Identifier. The resource name of the account relationship. Format: `accounts/{account}/relationships/{relationship}`. For example, `accounts/123456/relationships/567890`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The `AccountRelationship` message defines a formal connection between a merchant's account and a service provider's account. This relationship enables the provider to offer specific services to the business, such as product management or campaign management. It specifies the access rights and permissions to the business's data relevant to those services. Establishing an account relationship involves linking the merchant's account with a provider's account. The provider could be another Google account (like Google Ads or Google My Business) or a third-party platform (such as Shopify or WooCommerce).
+  "accountIdAlias": "A String", # Optional. An optional alias you can assign to this account relationship. This alias acts as a convenient identifier for your own reference and management. It must be unique among all your account relationships with the same provider. For example, you might use `account_id_alias` to assign a friendly name to this relationship for easier identification in your systems.
+  "name": "A String", # Identifier. The resource name of the account relationship. Format: `accounts/{account}/relationships/{relationship}`. For example, `accounts/123456/relationships/567890`.
+  "provider": "A String", # Immutable. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
+  "providerDisplayName": "A String", # Output only. The human-readable display name of the provider account.
+}
+
+  updateMask: string, Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `account_id_alias`
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `AccountRelationship` message defines a formal connection between a merchant's account and a service provider's account. This relationship enables the provider to offer specific services to the business, such as product management or campaign management. It specifies the access rights and permissions to the business's data relevant to those services. Establishing an account relationship involves linking the merchant's account with a provider's account. The provider could be another Google account (like Google Ads or Google My Business) or a third-party platform (such as Shopify or WooCommerce).
+  "accountIdAlias": "A String", # Optional. An optional alias you can assign to this account relationship. This alias acts as a convenient identifier for your own reference and management. It must be unique among all your account relationships with the same provider. For example, you might use `account_id_alias` to assign a friendly name to this relationship for easier identification in your systems.
+  "name": "A String", # Identifier. The resource name of the account relationship. Format: `accounts/{account}/relationships/{relationship}`. For example, `accounts/123456/relationships/567890`.
+  "provider": "A String", # Immutable. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
+  "providerDisplayName": "A String", # Output only. The human-readable display name of the provider account.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.services.html b/docs/dyn/merchantapi_accounts_v1.accounts.services.html
new file mode 100644
index 00000000000..76906df50ff
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.services.html
@@ -0,0 +1,331 @@
+
+
+
+
Merchant API . accounts . services

+
Instance Methods

+

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

+
Approve an account service proposal.

+

+  close()

+
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

+
Retrieve an account service.

+

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

+
List account services for the specified accounts. Supports filtering.

+

+  list_next()

+
Retrieves the next page of results.

+

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

+
Propose an account service.

+

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

+
Reject an account service (both proposed and approve services can be rejected).

+
Method Details

+

+    approve(name, body=None, x__xgafv=None)
+  
Approve an account service proposal.
+
+Args:
+  name: string, Required. The resource name of the account service to approve. Format: `accounts/{account}/services/{service}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request to approve an account service.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `AccountService` message represents a specific service that a provider account offers to a Merchant Center account. `AccountService` defines the permissions and capabilities granted to the provider, allowing for operations such as product management or campaign management. The lifecycle of an `AccountService` involves a proposal phase, where one party suggests the service, and an approval phase, where the other party accepts or rejects it. This handshake mechanism ensures mutual consent before any access is granted. This mechanism safeguards both parties by ensuring that access rights are granted appropriately and that both the business and provider are aware of the services enabled. In scenarios where a user is an admin of both accounts, the approval can happen automatically. The mutability of a service is also managed through `AccountService`. Some services might be immutable, for example, if they were established through other systems or APIs, and you cannot alter them through this API.
+  "accountAggregation": { # `AccountAggregation` payload. # Service type for account aggregation. This enables the provider, which is an advanced account, to manage multiple sub-accounts (client accounts). Through this service, the advanced account provider can perform administrative and operational tasks across all linked sub-accounts. This is useful for agencies, aggregators, or large retailers that need centralized control over many Merchant Center accounts.
+  },
+  "accountManagement": { # `AccountManagement` payload. # Service type for account management. Enables the provider to perform administrative actions on the business's account, such as configuring account settings, managing users, or updating business information.
+  },
+  "campaignsManagement": { # `CampaignManagement` payload. # Service type for managing advertising campaigns. Grants the provider access to create and manage the business's ad campaigns, including setting up campaigns, adjusting bids, and optimizing performance.
+  },
+  "externalAccountId": "A String", # Immutable. An optional, immutable identifier that Google uses to refer to this account when communicating with the provider. This should be the unique account ID within the provider's system (for example, your shop ID in Shopify). If you have multiple accounts with the same provider - for instance, different accounts for various regions — the `external_account_id` differentiates between them, ensuring accurate linking and integration between Google and the provider.
+  "handshake": { # The current status of establishing of the service. (for example, pending approval or approved). # Output only. Information about the state of the service in terms of establishing it (e.g. is it pending approval or approved).
+    "actor": "A String", # Output only. The most recent account to modify the account service's `approval_status`.
+    "approvalState": "A String", # Output only. The approval state of this handshake.
+  },
+  "localListingManagement": { # `LocalListingManagement` payload. # Service type for local listings management. The business group associated with the external account id will be used to provide local inventory to this Merchant Center account.
+  },
+  "mutability": "A String", # Output only. Whether the service is mutable (e.g. through Approve / Reject RPCs). A service that was created through another system or API might be immutable.
+  "name": "A String", # Identifier. The resource name of the account service. Format: `accounts/{account}/services/{service}`
+  "productsManagement": { # `ProductsManagement` payload. # Service type for managing products. This allows the provider to handle product data on behalf of the business, including reading and writing product listings. It's commonly used when the provider offers inventory management or catalog synchronization services to keep the business's product information up-to-date across platforms.
+  },
+  "provider": "A String", # Output only. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
+  "providerDisplayName": "A String", # Output only. The human-readable display name of the provider account.
+}

+

+
+

+    close()
+  
Close httplib2 connections.

+

+
+

+    get(name, x__xgafv=None)
+  
Retrieve an account service.
+
+Args:
+  name: string, Required. The resource name of the account service to get. Format: `accounts/{account}/services/{service}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `AccountService` message represents a specific service that a provider account offers to a Merchant Center account. `AccountService` defines the permissions and capabilities granted to the provider, allowing for operations such as product management or campaign management. The lifecycle of an `AccountService` involves a proposal phase, where one party suggests the service, and an approval phase, where the other party accepts or rejects it. This handshake mechanism ensures mutual consent before any access is granted. This mechanism safeguards both parties by ensuring that access rights are granted appropriately and that both the business and provider are aware of the services enabled. In scenarios where a user is an admin of both accounts, the approval can happen automatically. The mutability of a service is also managed through `AccountService`. Some services might be immutable, for example, if they were established through other systems or APIs, and you cannot alter them through this API.
+  "accountAggregation": { # `AccountAggregation` payload. # Service type for account aggregation. This enables the provider, which is an advanced account, to manage multiple sub-accounts (client accounts). Through this service, the advanced account provider can perform administrative and operational tasks across all linked sub-accounts. This is useful for agencies, aggregators, or large retailers that need centralized control over many Merchant Center accounts.
+  },
+  "accountManagement": { # `AccountManagement` payload. # Service type for account management. Enables the provider to perform administrative actions on the business's account, such as configuring account settings, managing users, or updating business information.
+  },
+  "campaignsManagement": { # `CampaignManagement` payload. # Service type for managing advertising campaigns. Grants the provider access to create and manage the business's ad campaigns, including setting up campaigns, adjusting bids, and optimizing performance.
+  },
+  "externalAccountId": "A String", # Immutable. An optional, immutable identifier that Google uses to refer to this account when communicating with the provider. This should be the unique account ID within the provider's system (for example, your shop ID in Shopify). If you have multiple accounts with the same provider - for instance, different accounts for various regions — the `external_account_id` differentiates between them, ensuring accurate linking and integration between Google and the provider.
+  "handshake": { # The current status of establishing of the service. (for example, pending approval or approved). # Output only. Information about the state of the service in terms of establishing it (e.g. is it pending approval or approved).
+    "actor": "A String", # Output only. The most recent account to modify the account service's `approval_status`.
+    "approvalState": "A String", # Output only. The approval state of this handshake.
+  },
+  "localListingManagement": { # `LocalListingManagement` payload. # Service type for local listings management. The business group associated with the external account id will be used to provide local inventory to this Merchant Center account.
+  },
+  "mutability": "A String", # Output only. Whether the service is mutable (e.g. through Approve / Reject RPCs). A service that was created through another system or API might be immutable.
+  "name": "A String", # Identifier. The resource name of the account service. Format: `accounts/{account}/services/{service}`
+  "productsManagement": { # `ProductsManagement` payload. # Service type for managing products. This allows the provider to handle product data on behalf of the business, including reading and writing product listings. It's commonly used when the provider offers inventory management or catalog synchronization services to keep the business's product information up-to-date across platforms.
+  },
+  "provider": "A String", # Output only. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
+  "providerDisplayName": "A String", # Output only. The human-readable display name of the provider account.
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
List account services for the specified accounts. Supports filtering.
+
+Args:
+  parent: string, Required. The parent account of the account service to filter by. Format: `accounts/{account}` (required)
+  pageSize: integer, Optional. The maximum number of elements to return in the response. Use for paging. If no `page_size` is specified, `100` is used as the default value. The maximum allowed value is `1000`.
+  pageToken: string, Optional. The token returned by the previous `list` request.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response after trying to list account services.
+  "accountServices": [ # The account services that match your filter.
+    { # The `AccountService` message represents a specific service that a provider account offers to a Merchant Center account. `AccountService` defines the permissions and capabilities granted to the provider, allowing for operations such as product management or campaign management. The lifecycle of an `AccountService` involves a proposal phase, where one party suggests the service, and an approval phase, where the other party accepts or rejects it. This handshake mechanism ensures mutual consent before any access is granted. This mechanism safeguards both parties by ensuring that access rights are granted appropriately and that both the business and provider are aware of the services enabled. In scenarios where a user is an admin of both accounts, the approval can happen automatically. The mutability of a service is also managed through `AccountService`. Some services might be immutable, for example, if they were established through other systems or APIs, and you cannot alter them through this API.
+      "accountAggregation": { # `AccountAggregation` payload. # Service type for account aggregation. This enables the provider, which is an advanced account, to manage multiple sub-accounts (client accounts). Through this service, the advanced account provider can perform administrative and operational tasks across all linked sub-accounts. This is useful for agencies, aggregators, or large retailers that need centralized control over many Merchant Center accounts.
+      },
+      "accountManagement": { # `AccountManagement` payload. # Service type for account management. Enables the provider to perform administrative actions on the business's account, such as configuring account settings, managing users, or updating business information.
+      },
+      "campaignsManagement": { # `CampaignManagement` payload. # Service type for managing advertising campaigns. Grants the provider access to create and manage the business's ad campaigns, including setting up campaigns, adjusting bids, and optimizing performance.
+      },
+      "externalAccountId": "A String", # Immutable. An optional, immutable identifier that Google uses to refer to this account when communicating with the provider. This should be the unique account ID within the provider's system (for example, your shop ID in Shopify). If you have multiple accounts with the same provider - for instance, different accounts for various regions — the `external_account_id` differentiates between them, ensuring accurate linking and integration between Google and the provider.
+      "handshake": { # The current status of establishing of the service. (for example, pending approval or approved). # Output only. Information about the state of the service in terms of establishing it (e.g. is it pending approval or approved).
+        "actor": "A String", # Output only. The most recent account to modify the account service's `approval_status`.
+        "approvalState": "A String", # Output only. The approval state of this handshake.
+      },
+      "localListingManagement": { # `LocalListingManagement` payload. # Service type for local listings management. The business group associated with the external account id will be used to provide local inventory to this Merchant Center account.
+      },
+      "mutability": "A String", # Output only. Whether the service is mutable (e.g. through Approve / Reject RPCs). A service that was created through another system or API might be immutable.
+      "name": "A String", # Identifier. The resource name of the account service. Format: `accounts/{account}/services/{service}`
+      "productsManagement": { # `ProductsManagement` payload. # Service type for managing products. This allows the provider to handle product data on behalf of the business, including reading and writing product listings. It's commonly used when the provider offers inventory management or catalog synchronization services to keep the business's product information up-to-date across platforms.
+      },
+      "provider": "A String", # Output only. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
+      "providerDisplayName": "A String", # Output only. The human-readable display name of the provider account.
+    },
+  ],
+  "nextPageToken": "A String", # A page token. You can send the `page_token` to get the next page. Only included in the `list` response if there are more pages.
+}

+

+
+

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

+

+
+

+    propose(parent, body=None, x__xgafv=None)
+  
Propose an account service.
+
+Args:
+  parent: string, Required. The resource name of the parent account for the service. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request to propose an account service.
+  "accountService": { # The `AccountService` message represents a specific service that a provider account offers to a Merchant Center account. `AccountService` defines the permissions and capabilities granted to the provider, allowing for operations such as product management or campaign management. The lifecycle of an `AccountService` involves a proposal phase, where one party suggests the service, and an approval phase, where the other party accepts or rejects it. This handshake mechanism ensures mutual consent before any access is granted. This mechanism safeguards both parties by ensuring that access rights are granted appropriately and that both the business and provider are aware of the services enabled. In scenarios where a user is an admin of both accounts, the approval can happen automatically. The mutability of a service is also managed through `AccountService`. Some services might be immutable, for example, if they were established through other systems or APIs, and you cannot alter them through this API. # Required. The account service to propose.
+    "accountAggregation": { # `AccountAggregation` payload. # Service type for account aggregation. This enables the provider, which is an advanced account, to manage multiple sub-accounts (client accounts). Through this service, the advanced account provider can perform administrative and operational tasks across all linked sub-accounts. This is useful for agencies, aggregators, or large retailers that need centralized control over many Merchant Center accounts.
+    },
+    "accountManagement": { # `AccountManagement` payload. # Service type for account management. Enables the provider to perform administrative actions on the business's account, such as configuring account settings, managing users, or updating business information.
+    },
+    "campaignsManagement": { # `CampaignManagement` payload. # Service type for managing advertising campaigns. Grants the provider access to create and manage the business's ad campaigns, including setting up campaigns, adjusting bids, and optimizing performance.
+    },
+    "externalAccountId": "A String", # Immutable. An optional, immutable identifier that Google uses to refer to this account when communicating with the provider. This should be the unique account ID within the provider's system (for example, your shop ID in Shopify). If you have multiple accounts with the same provider - for instance, different accounts for various regions — the `external_account_id` differentiates between them, ensuring accurate linking and integration between Google and the provider.
+    "handshake": { # The current status of establishing of the service. (for example, pending approval or approved). # Output only. Information about the state of the service in terms of establishing it (e.g. is it pending approval or approved).
+      "actor": "A String", # Output only. The most recent account to modify the account service's `approval_status`.
+      "approvalState": "A String", # Output only. The approval state of this handshake.
+    },
+    "localListingManagement": { # `LocalListingManagement` payload. # Service type for local listings management. The business group associated with the external account id will be used to provide local inventory to this Merchant Center account.
+    },
+    "mutability": "A String", # Output only. Whether the service is mutable (e.g. through Approve / Reject RPCs). A service that was created through another system or API might be immutable.
+    "name": "A String", # Identifier. The resource name of the account service. Format: `accounts/{account}/services/{service}`
+    "productsManagement": { # `ProductsManagement` payload. # Service type for managing products. This allows the provider to handle product data on behalf of the business, including reading and writing product listings. It's commonly used when the provider offers inventory management or catalog synchronization services to keep the business's product information up-to-date across platforms.
+    },
+    "provider": "A String", # Output only. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
+    "providerDisplayName": "A String", # Output only. The human-readable display name of the provider account.
+  },
+  "provider": "A String", # Required. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `AccountService` message represents a specific service that a provider account offers to a Merchant Center account. `AccountService` defines the permissions and capabilities granted to the provider, allowing for operations such as product management or campaign management. The lifecycle of an `AccountService` involves a proposal phase, where one party suggests the service, and an approval phase, where the other party accepts or rejects it. This handshake mechanism ensures mutual consent before any access is granted. This mechanism safeguards both parties by ensuring that access rights are granted appropriately and that both the business and provider are aware of the services enabled. In scenarios where a user is an admin of both accounts, the approval can happen automatically. The mutability of a service is also managed through `AccountService`. Some services might be immutable, for example, if they were established through other systems or APIs, and you cannot alter them through this API.
+  "accountAggregation": { # `AccountAggregation` payload. # Service type for account aggregation. This enables the provider, which is an advanced account, to manage multiple sub-accounts (client accounts). Through this service, the advanced account provider can perform administrative and operational tasks across all linked sub-accounts. This is useful for agencies, aggregators, or large retailers that need centralized control over many Merchant Center accounts.
+  },
+  "accountManagement": { # `AccountManagement` payload. # Service type for account management. Enables the provider to perform administrative actions on the business's account, such as configuring account settings, managing users, or updating business information.
+  },
+  "campaignsManagement": { # `CampaignManagement` payload. # Service type for managing advertising campaigns. Grants the provider access to create and manage the business's ad campaigns, including setting up campaigns, adjusting bids, and optimizing performance.
+  },
+  "externalAccountId": "A String", # Immutable. An optional, immutable identifier that Google uses to refer to this account when communicating with the provider. This should be the unique account ID within the provider's system (for example, your shop ID in Shopify). If you have multiple accounts with the same provider - for instance, different accounts for various regions — the `external_account_id` differentiates between them, ensuring accurate linking and integration between Google and the provider.
+  "handshake": { # The current status of establishing of the service. (for example, pending approval or approved). # Output only. Information about the state of the service in terms of establishing it (e.g. is it pending approval or approved).
+    "actor": "A String", # Output only. The most recent account to modify the account service's `approval_status`.
+    "approvalState": "A String", # Output only. The approval state of this handshake.
+  },
+  "localListingManagement": { # `LocalListingManagement` payload. # Service type for local listings management. The business group associated with the external account id will be used to provide local inventory to this Merchant Center account.
+  },
+  "mutability": "A String", # Output only. Whether the service is mutable (e.g. through Approve / Reject RPCs). A service that was created through another system or API might be immutable.
+  "name": "A String", # Identifier. The resource name of the account service. Format: `accounts/{account}/services/{service}`
+  "productsManagement": { # `ProductsManagement` payload. # Service type for managing products. This allows the provider to handle product data on behalf of the business, including reading and writing product listings. It's commonly used when the provider offers inventory management or catalog synchronization services to keep the business's product information up-to-date across platforms.
+  },
+  "provider": "A String", # Output only. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
+  "providerDisplayName": "A String", # Output only. The human-readable display name of the provider account.
+}

+

+
+

+    reject(name, body=None, x__xgafv=None)
+  
Reject an account service (both proposed and approve services can be rejected).
+
+Args:
+  name: string, Required. The resource name of the account service to reject. Format: `accounts/{account}/services/{service}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request to reject an account service.
+}
+
+  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); }
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.shippingSettings.html b/docs/dyn/merchantapi_accounts_v1.accounts.shippingSettings.html
new file mode 100644
index 00000000000..c4b4dd233d2
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.shippingSettings.html
@@ -0,0 +1,1049 @@
+
+
+
+
Merchant API . accounts . shippingSettings

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  getShippingSettings(name, x__xgafv=None)

+
Retrieve shipping setting information.

+

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

+
Replace the shipping setting of a business with the request shipping setting. Executing this method requires admin access.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    getShippingSettings(name, x__xgafv=None)
+  
Retrieve shipping setting information.
+
+Args:
+  name: string, Required. The name of the shipping setting to retrieve. Format: `accounts/{account}/shippingsettings` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The Merchant Center account's [shipping settings](https://support.google.com/merchants/answer/6069284). The `ShippingSettings` resource lets you retrieve and update the shipping settings of your advanced account and all its associated sub-accounts.
+  "etag": "A String", # Required. This field helps avoid async issues. It ensures that the shipping setting data doesn't change between the `get` call and the `insert` call. The user should follow these steps: 1. Set the etag field as an empty string for the initial shipping setting creation. 2. After the initial creation, call the `get` method to obtain an etag and the current shipping setting data before calling `insert`. 3. Modify the shipping setting information. 4. Call the `insert` method with the shipping setting information and the etag obtained in step 2. 5. If the shipping setting data changes between step 2 and step 4, the insert request will fail because the etag changes every time the shipping setting data changes. In this case, the user should repeat steps 2-4 with the new etag.
+  "name": "A String", # Identifier. The resource name of the shipping settings. Format: `accounts/{account}/shippingSettings`. For example, `accounts/123456/shippingSettings`.
+  "services": [ # Optional. The target account's list of services.
+    { # Shipping service.
+      "active": True or False, # Required. A boolean exposing the active status of the shipping service.
+      "currencyCode": "A String", # Required. The CLDR code of the currency to which this service applies. Must match that of the prices in rate groups.
+      "deliveryCountries": [ # Required. The CLDR territory code of the countries to which the service applies.
+        "A String",
+      ],
+      "deliveryTime": { # Time spent in various aspects from order to the delivery of the product. # Required. Time spent in various aspects from order to the delivery of the product.
+        "cutoffTime": { # Business days cutoff time definition. # Business days cutoff time definition. If not configured the cutoff time will be defaulted to 8AM PST.
+          "hour": 42, # Required. Hour of the cutoff time until which an order has to be placed to be processed in the same day.
+          "minute": 42, # Required. Minute of the cutoff time until which an order has to be placed to be processed in the same day.
+          "timeZone": "A String", # Required. [Timezone identifier](https://developers.google.com/adwords/api/docs/appendix/codes-formats#timezone-ids) For example "Europe/Zurich".
+        },
+        "handlingBusinessDayConfig": { # Business days of the warehouse. # The business days during which orders can be handled. If not provided, Monday to Friday business days will be assumed.
+          "businessDays": [ # Required. Regular business days. May not be empty.
+            "A String",
+          ],
+        },
+        "maxHandlingDays": 42, # Maximum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. Must be greater than or equal to `min_handling_days`. 'min_handling_days' and 'max_handling_days' should be either set or not set at the same time.
+        "maxTransitDays": 42, # Maximum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Must be greater than or equal to `min_transit_days`.
+        "minHandlingDays": 42, # Minimum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. 'min_handling_days' and 'max_handling_days' should be either set or not set at the same time.
+        "minTransitDays": 42, # Minimum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Either `min_transit_days`, `max_transit_days` or `transit_time_table` must be set, but not both.
+        "transitBusinessDayConfig": { # Business days of the warehouse. # The business days during which orders can be in-transit. If not provided, Monday to Friday business days will be assumed.
+          "businessDays": [ # Required. Regular business days. May not be empty.
+            "A String",
+          ],
+        },
+        "transitTimeTable": { # Transit time table, number of business days spent in transit based on row and column dimensions. Either `min_transit_days`, `max_transit_days` or `transit_time_table` can be set, but not both. # Transit time table, number of business days spent in transit based on row and column dimensions. Either `min_transit_days`, `max_transit_days` or `transit_time_table` can be set, but not both.
+          "postalCodeGroupNames": [ # Required. A list of region names Region.name . The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service.
+            "A String",
+          ],
+          "rows": [ # Required. If there's only one dimension set of `postal_code_group_names` or `transit_time_labels`, there are multiple rows each with one value for that dimension. If there are two dimensions, each row corresponds to a `postal_code_group_names`, and columns (values) to a `transit_time_labels`.
+            { # If there's only one dimension set of `postal_code_group_names` or `transit_time_labels`, there are multiple rows each with one value for that dimension. If there are two dimensions, each row corresponds to a `postal_code_group_names`, and columns (values) to a `transit_time_labels`.
+              "values": [ # Required. Transit time range (min-max) in business days.
+                { # Transit time range (min-max) in business days.
+                  "maxTransitDays": 42, # Must be greater than or equal to `min_transit_days`.
+                  "minTransitDays": 42, # Minimum transit time range in business days. 0 means same day delivery, 1 means next day delivery.
+                },
+              ],
+            },
+          ],
+          "transitTimeLabels": [ # Required. A list of transit time labels. The last value can be `"all other labels"`. Example: `["food", "electronics", "all other labels"]`.
+            "A String",
+          ],
+        },
+        "warehouseBasedDeliveryTimes": [ # Optional. Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the settings of the selected carrier. When set, no other transit time related field in delivery time should be set.
+          { # Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the settings of the selected carrier. When set, no other transit time related field in `delivery_time` should be set.
+            "carrier": "A String", # Required. Carrier, such as `"UPS"` or `"Fedex"`. [supported carriers](https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-and-us-only)
+            "carrierService": "A String", # Required. Carrier service, such as `"ground"` or `"2 days"`. The name of the service must be in the eddSupportedServices list.
+            "warehouse": "A String", # Required. Warehouse name. This should match warehouse.
+          },
+        ],
+      },
+      "loyaltyPrograms": [ # Optional. Loyalty programs that this shipping service is limited to.
+        { # [Loyalty program](https://support.google.com/merchants/answer/12922446) provided by a business.
+          "loyaltyProgramTiers": [ # Optional. Loyalty program tier of this shipping service.
+            { # Subset of a business's loyalty program.
+              "tierLabel": "A String", # The tier label [tier_label] sub-attribute differentiates offer level benefits between each tier. This value is also set in your program settings in Merchant Center, and is required for data source changes even if your loyalty program only has 1 tier.
+            },
+          ],
+          "programLabel": "A String", # This is the loyalty program label set in your loyalty program settings in Merchant Center. This sub-attribute allows Google to map your loyalty program to eligible offers.
+        },
+      ],
+      "minimumOrderValue": { # The price represented as a number and currency. # Optional. Minimum order value for this service. If set, indicates that customers will have to spend at least this amount. All prices within a service must have the same currency. Cannot be set together with `minimum_order_value_table`.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "minimumOrderValueTable": { # Table of per store minimum order values for the pickup fulfillment type. # Optional. Table of per store minimum order values for the pickup fulfillment type. Cannot be set together with `minimum_order_value`.
+        "storeCodeSetWithMovs": [ # Required. A list of store code sets sharing the same minimum order value (MOV). At least two sets are required and the last one must be empty, which signifies 'MOV for all other stores'. Each store code can only appear once across all the sets. All prices within a service must have the same currency.
+          { # A list of store code sets sharing the same minimum order value. At least two sets are required and the last one must be empty, which signifies 'MOV for all other stores'. Each store code can only appear once across all the sets. All prices within a service must have the same currency.
+            "storeCodes": [ # Optional. A list of unique store codes or empty for the catch all.
+              "A String",
+            ],
+            "value": { # The price represented as a number and currency. # The minimum order value for the given stores.
+              "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+              "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+            },
+          },
+        ],
+      },
+      "rateGroups": [ # Optional. Shipping rate group definitions. Only the last one is allowed to have an empty `applicable_shipping_labels`, which means "everything else". The other `applicable_shipping_labels` must not overlap.
+        { # Shipping rate group definitions. Only the last one is allowed to have an empty `applicable_shipping_labels`, which means "everything else". The other `applicable_shipping_labels` must not overlap.
+          "applicableShippingLabels": [ # Required. A list of [shipping labels](https://support.google.com/merchants/answer/6324504) defining the products to which this rate group applies to. This is a disjunction: only one of the labels has to match for the rate group to apply. May only be empty for the last rate group of a service.
+            "A String",
+          ],
+          "carrierRates": [ # Optional. A list of carrier rates that can be referred to by `main_table` or `single_value`.
+            { # A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported carrier services are defined in https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.
+              "carrier": "A String", # Required. Carrier service, such as `"UPS"` or `"Fedex"`.
+              "carrierService": "A String", # Required. Carrier service, such as `"ground"` or `"2 days"`.
+              "flatAdjustment": { # The price represented as a number and currency. # Optional. Additive shipping rate modifier. Can be negative. For example `{ "amount_micros": 1, "currency_code" : "USD" }` adds $1 to the rate, `{ "amount_micros": -3, "currency_code" : "USD" }` removes $3 from the rate.
+                "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+              },
+              "name": "A String", # Required. Name of the carrier rate. Must be unique per rate group.
+              "originPostalCode": "A String", # Required. Shipping origin for this carrier rate.
+              "percentageAdjustment": "A String", # Optional. Multiplicative shipping rate modifier as a number in decimal notation. Can be negative. For example `"5.4"` increases the rate by 5.4%, `"-3"` decreases the rate by 3%.
+            },
+          ],
+          "mainTable": { # A table defining the rate group, when `single_value` is not expressive enough. # A table defining the rate group, when `single_value` is not expressive enough. Can only be set if `single_value` is not set.
+            "columnHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Headers of the table's columns. Optional: if not set then the table has only one dimension.
+              "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                    "A String",
+                  ],
+                },
+              ],
+              "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The price represented as a number and currency.
+                  "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                  "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                },
+              ],
+              "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The weight represented as the value in string and the unit.
+                  "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                  "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                },
+              ],
+            },
+            "name": "A String", # Name of the table. Required for subtables, ignored for the main table.
+            "rowHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Required. Headers of the table's rows.
+              "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                    "A String",
+                  ],
+                },
+              ],
+              "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The price represented as a number and currency.
+                  "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                  "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                },
+              ],
+              "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The weight represented as the value in string and the unit.
+                  "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                  "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                },
+              ],
+            },
+            "rows": [ # Required. The list of rows that constitute the table. Must have the same length as `row_headers`.
+              { # Include a list of cells.
+                "cells": [ # Required. The list of cells that constitute the row. Must have the same length as `columnHeaders` for two-dimensional tables, a length of 1 for one-dimensional tables.
+                  { # The single value of a rate group or the value of a rate group table's cell. Exactly one of `no_shipping`, `flat_rate`, `price_percentage`, `carrier_rateName`, `subtable_name` must be set.
+                    "carrierRate": "A String", # The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set.
+                    "flatRate": { # The price represented as a number and currency. # A flat rate. Can only be set if all other fields are not set.
+                      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                    },
+                    "noShipping": True or False, # If true, then the product can't be shipped. Must be true when set, can only be set if all other fields are not set.
+                    "pricePercentage": "A String", # A percentage of the price represented as a number in decimal notation (For example, `"5.4"`). Can only be set if all other fields are not set.
+                    "subtable": "A String", # The name of a subtable. Can only be set in table cells (For example, not for single values), and only if all other fields are not set.
+                  },
+                ],
+              },
+            ],
+          },
+          "name": "A String", # Optional. Name of the rate group. If set has to be unique within shipping service.
+          "singleValue": { # The single value of a rate group or the value of a rate group table's cell. Exactly one of `no_shipping`, `flat_rate`, `price_percentage`, `carrier_rateName`, `subtable_name` must be set. # The value of the rate group (For example flat rate $10). Can only be set if `main_table` and `subtables` are not set.
+            "carrierRate": "A String", # The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set.
+            "flatRate": { # The price represented as a number and currency. # A flat rate. Can only be set if all other fields are not set.
+              "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+              "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+            },
+            "noShipping": True or False, # If true, then the product can't be shipped. Must be true when set, can only be set if all other fields are not set.
+            "pricePercentage": "A String", # A percentage of the price represented as a number in decimal notation (For example, `"5.4"`). Can only be set if all other fields are not set.
+            "subtable": "A String", # The name of a subtable. Can only be set in table cells (For example, not for single values), and only if all other fields are not set.
+          },
+          "subtables": [ # Optional. A list of subtables referred to by `main_table`. Can only be set if `main_table` is set.
+            { # A table defining the rate group, when `single_value` is not expressive enough.
+              "columnHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Headers of the table's columns. Optional: if not set then the table has only one dimension.
+                "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                    "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                      "A String",
+                    ],
+                  },
+                ],
+                "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The price represented as a number and currency.
+                    "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                    "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                  },
+                ],
+                "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The weight represented as the value in string and the unit.
+                    "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                    "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                  },
+                ],
+              },
+              "name": "A String", # Name of the table. Required for subtables, ignored for the main table.
+              "rowHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Required. Headers of the table's rows.
+                "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                    "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                      "A String",
+                    ],
+                  },
+                ],
+                "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The price represented as a number and currency.
+                    "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                    "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                  },
+                ],
+                "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The weight represented as the value in string and the unit.
+                    "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                    "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                  },
+                ],
+              },
+              "rows": [ # Required. The list of rows that constitute the table. Must have the same length as `row_headers`.
+                { # Include a list of cells.
+                  "cells": [ # Required. The list of cells that constitute the row. Must have the same length as `columnHeaders` for two-dimensional tables, a length of 1 for one-dimensional tables.
+                    { # The single value of a rate group or the value of a rate group table's cell. Exactly one of `no_shipping`, `flat_rate`, `price_percentage`, `carrier_rateName`, `subtable_name` must be set.
+                      "carrierRate": "A String", # The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set.
+                      "flatRate": { # The price represented as a number and currency. # A flat rate. Can only be set if all other fields are not set.
+                        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                      },
+                      "noShipping": True or False, # If true, then the product can't be shipped. Must be true when set, can only be set if all other fields are not set.
+                      "pricePercentage": "A String", # A percentage of the price represented as a number in decimal notation (For example, `"5.4"`). Can only be set if all other fields are not set.
+                      "subtable": "A String", # The name of a subtable. Can only be set in table cells (For example, not for single values), and only if all other fields are not set.
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
+        },
+      ],
+      "serviceName": "A String", # Required. Free-form name of the service. Must be unique within target account.
+      "shipmentType": "A String", # Optional. Type of locations this service ships orders to.
+      "storeConfig": { # A list of stores your products are delivered from. This is only valid for the local delivery shipment type. # A list of stores your products are delivered from. This is only valid for the local delivery shipment type.
+        "cutoffConfig": { # Configs related to local delivery ends for the day. # Configs related to local delivery ends for the day.
+          "localCutoffTime": { # Time that local delivery ends for the day. # Time that local delivery ends for the day.
+            "hour": "A String", # Hour local delivery orders must be placed by to process the same day.
+            "minute": "A String", # Minute local delivery orders must be placed by to process the same day.
+          },
+          "noDeliveryPostCutoff": True or False, # Businesses can opt-out of showing n+1 day local delivery when they have a shipping service configured to n day local delivery. For example, if the shipping service defines same-day delivery, and it's past the cut-off, setting this field to `true` results in the calculated shipping service rate returning `NO_DELIVERY_POST_CUTOFF`. In the same example, setting this field to `false` results in the calculated shipping time being one day. This is only for local delivery.
+          "storeCloseOffsetHours": "A String", # Only valid with local delivery fulfillment. Represents cutoff time as the number of hours before store closing. Mutually exclusive with `local_cutoff_time`.
+        },
+        "serviceRadius": { # Maximum delivery radius. This is only required for the local delivery shipment type. # Maximum delivery radius. This is only required for the local delivery shipment type.
+          "unit": "A String", # Unit can differ based on country, it is parameterized to include miles and kilometers.
+          "value": "A String", # Integer value of distance.
+        },
+        "storeCodes": [ # Optional. A list of store codes that provide local delivery. If empty, then `all_stores` must be true.
+          "A String",
+        ],
+        "storeServiceType": "A String", # Indicates whether all stores, or selected stores, listed by this business provide local delivery.
+      },
+    },
+  ],
+  "warehouses": [ # Optional. A list of warehouses which can be referred to in `services`.
+    { # A fulfillment warehouse, which stores and handles inventory.
+      "businessDayConfig": { # Business days of the warehouse. # Business days of the warehouse. If not set, will be Monday to Friday by default.
+        "businessDays": [ # Required. Regular business days. May not be empty.
+          "A String",
+        ],
+      },
+      "cutoffTime": { # The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code. # Required. The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code.
+        "hour": 42, # Required. Hour of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Hour is based on the timezone of warehouse.
+        "minute": 42, # Required. Minute of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Minute is based on the timezone of warehouse.
+      },
+      "handlingDays": "A String", # Required. The number of days it takes for this warehouse to pack up and ship an item. This is on the warehouse level, but can be overridden on the offer level based on the attributes of an item.
+      "name": "A String", # Required. The name of the warehouse. Must be unique within account.
+      "shippingAddress": { # Shipping address of the warehouse. # Required. Shipping address of the warehouse.
+        "administrativeArea": "A String", # Required. Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+        "city": "A String", # Required. City, town or commune. May also include dependent localities or sublocalities (For example neighborhoods or suburbs).
+        "postalCode": "A String", # Required. Postal code or ZIP (For example "94043").
+        "regionCode": "A String", # Required. [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (For example "US").
+        "streetAddress": "A String", # Street-level part of the address. For example: `111w 31st Street`.
+      },
+    },
+  ],
+}

+

+
+

+    insert(parent, body=None, x__xgafv=None)
+  
Replace the shipping setting of a business with the request shipping setting. Executing this method requires admin access.
+
+Args:
+  parent: string, Required. The account for which this shipping setting will be inserted. If you are using an advanced account, you must specify the unique identifier of the sub-account for which you want to insert the shipping setting. Format: `accounts/{ACCOUNT_ID}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The Merchant Center account's [shipping settings](https://support.google.com/merchants/answer/6069284). The `ShippingSettings` resource lets you retrieve and update the shipping settings of your advanced account and all its associated sub-accounts.
+  "etag": "A String", # Required. This field helps avoid async issues. It ensures that the shipping setting data doesn't change between the `get` call and the `insert` call. The user should follow these steps: 1. Set the etag field as an empty string for the initial shipping setting creation. 2. After the initial creation, call the `get` method to obtain an etag and the current shipping setting data before calling `insert`. 3. Modify the shipping setting information. 4. Call the `insert` method with the shipping setting information and the etag obtained in step 2. 5. If the shipping setting data changes between step 2 and step 4, the insert request will fail because the etag changes every time the shipping setting data changes. In this case, the user should repeat steps 2-4 with the new etag.
+  "name": "A String", # Identifier. The resource name of the shipping settings. Format: `accounts/{account}/shippingSettings`. For example, `accounts/123456/shippingSettings`.
+  "services": [ # Optional. The target account's list of services.
+    { # Shipping service.
+      "active": True or False, # Required. A boolean exposing the active status of the shipping service.
+      "currencyCode": "A String", # Required. The CLDR code of the currency to which this service applies. Must match that of the prices in rate groups.
+      "deliveryCountries": [ # Required. The CLDR territory code of the countries to which the service applies.
+        "A String",
+      ],
+      "deliveryTime": { # Time spent in various aspects from order to the delivery of the product. # Required. Time spent in various aspects from order to the delivery of the product.
+        "cutoffTime": { # Business days cutoff time definition. # Business days cutoff time definition. If not configured the cutoff time will be defaulted to 8AM PST.
+          "hour": 42, # Required. Hour of the cutoff time until which an order has to be placed to be processed in the same day.
+          "minute": 42, # Required. Minute of the cutoff time until which an order has to be placed to be processed in the same day.
+          "timeZone": "A String", # Required. [Timezone identifier](https://developers.google.com/adwords/api/docs/appendix/codes-formats#timezone-ids) For example "Europe/Zurich".
+        },
+        "handlingBusinessDayConfig": { # Business days of the warehouse. # The business days during which orders can be handled. If not provided, Monday to Friday business days will be assumed.
+          "businessDays": [ # Required. Regular business days. May not be empty.
+            "A String",
+          ],
+        },
+        "maxHandlingDays": 42, # Maximum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. Must be greater than or equal to `min_handling_days`. 'min_handling_days' and 'max_handling_days' should be either set or not set at the same time.
+        "maxTransitDays": 42, # Maximum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Must be greater than or equal to `min_transit_days`.
+        "minHandlingDays": 42, # Minimum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. 'min_handling_days' and 'max_handling_days' should be either set or not set at the same time.
+        "minTransitDays": 42, # Minimum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Either `min_transit_days`, `max_transit_days` or `transit_time_table` must be set, but not both.
+        "transitBusinessDayConfig": { # Business days of the warehouse. # The business days during which orders can be in-transit. If not provided, Monday to Friday business days will be assumed.
+          "businessDays": [ # Required. Regular business days. May not be empty.
+            "A String",
+          ],
+        },
+        "transitTimeTable": { # Transit time table, number of business days spent in transit based on row and column dimensions. Either `min_transit_days`, `max_transit_days` or `transit_time_table` can be set, but not both. # Transit time table, number of business days spent in transit based on row and column dimensions. Either `min_transit_days`, `max_transit_days` or `transit_time_table` can be set, but not both.
+          "postalCodeGroupNames": [ # Required. A list of region names Region.name . The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service.
+            "A String",
+          ],
+          "rows": [ # Required. If there's only one dimension set of `postal_code_group_names` or `transit_time_labels`, there are multiple rows each with one value for that dimension. If there are two dimensions, each row corresponds to a `postal_code_group_names`, and columns (values) to a `transit_time_labels`.
+            { # If there's only one dimension set of `postal_code_group_names` or `transit_time_labels`, there are multiple rows each with one value for that dimension. If there are two dimensions, each row corresponds to a `postal_code_group_names`, and columns (values) to a `transit_time_labels`.
+              "values": [ # Required. Transit time range (min-max) in business days.
+                { # Transit time range (min-max) in business days.
+                  "maxTransitDays": 42, # Must be greater than or equal to `min_transit_days`.
+                  "minTransitDays": 42, # Minimum transit time range in business days. 0 means same day delivery, 1 means next day delivery.
+                },
+              ],
+            },
+          ],
+          "transitTimeLabels": [ # Required. A list of transit time labels. The last value can be `"all other labels"`. Example: `["food", "electronics", "all other labels"]`.
+            "A String",
+          ],
+        },
+        "warehouseBasedDeliveryTimes": [ # Optional. Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the settings of the selected carrier. When set, no other transit time related field in delivery time should be set.
+          { # Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the settings of the selected carrier. When set, no other transit time related field in `delivery_time` should be set.
+            "carrier": "A String", # Required. Carrier, such as `"UPS"` or `"Fedex"`. [supported carriers](https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-and-us-only)
+            "carrierService": "A String", # Required. Carrier service, such as `"ground"` or `"2 days"`. The name of the service must be in the eddSupportedServices list.
+            "warehouse": "A String", # Required. Warehouse name. This should match warehouse.
+          },
+        ],
+      },
+      "loyaltyPrograms": [ # Optional. Loyalty programs that this shipping service is limited to.
+        { # [Loyalty program](https://support.google.com/merchants/answer/12922446) provided by a business.
+          "loyaltyProgramTiers": [ # Optional. Loyalty program tier of this shipping service.
+            { # Subset of a business's loyalty program.
+              "tierLabel": "A String", # The tier label [tier_label] sub-attribute differentiates offer level benefits between each tier. This value is also set in your program settings in Merchant Center, and is required for data source changes even if your loyalty program only has 1 tier.
+            },
+          ],
+          "programLabel": "A String", # This is the loyalty program label set in your loyalty program settings in Merchant Center. This sub-attribute allows Google to map your loyalty program to eligible offers.
+        },
+      ],
+      "minimumOrderValue": { # The price represented as a number and currency. # Optional. Minimum order value for this service. If set, indicates that customers will have to spend at least this amount. All prices within a service must have the same currency. Cannot be set together with `minimum_order_value_table`.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "minimumOrderValueTable": { # Table of per store minimum order values for the pickup fulfillment type. # Optional. Table of per store minimum order values for the pickup fulfillment type. Cannot be set together with `minimum_order_value`.
+        "storeCodeSetWithMovs": [ # Required. A list of store code sets sharing the same minimum order value (MOV). At least two sets are required and the last one must be empty, which signifies 'MOV for all other stores'. Each store code can only appear once across all the sets. All prices within a service must have the same currency.
+          { # A list of store code sets sharing the same minimum order value. At least two sets are required and the last one must be empty, which signifies 'MOV for all other stores'. Each store code can only appear once across all the sets. All prices within a service must have the same currency.
+            "storeCodes": [ # Optional. A list of unique store codes or empty for the catch all.
+              "A String",
+            ],
+            "value": { # The price represented as a number and currency. # The minimum order value for the given stores.
+              "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+              "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+            },
+          },
+        ],
+      },
+      "rateGroups": [ # Optional. Shipping rate group definitions. Only the last one is allowed to have an empty `applicable_shipping_labels`, which means "everything else". The other `applicable_shipping_labels` must not overlap.
+        { # Shipping rate group definitions. Only the last one is allowed to have an empty `applicable_shipping_labels`, which means "everything else". The other `applicable_shipping_labels` must not overlap.
+          "applicableShippingLabels": [ # Required. A list of [shipping labels](https://support.google.com/merchants/answer/6324504) defining the products to which this rate group applies to. This is a disjunction: only one of the labels has to match for the rate group to apply. May only be empty for the last rate group of a service.
+            "A String",
+          ],
+          "carrierRates": [ # Optional. A list of carrier rates that can be referred to by `main_table` or `single_value`.
+            { # A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported carrier services are defined in https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.
+              "carrier": "A String", # Required. Carrier service, such as `"UPS"` or `"Fedex"`.
+              "carrierService": "A String", # Required. Carrier service, such as `"ground"` or `"2 days"`.
+              "flatAdjustment": { # The price represented as a number and currency. # Optional. Additive shipping rate modifier. Can be negative. For example `{ "amount_micros": 1, "currency_code" : "USD" }` adds $1 to the rate, `{ "amount_micros": -3, "currency_code" : "USD" }` removes $3 from the rate.
+                "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+              },
+              "name": "A String", # Required. Name of the carrier rate. Must be unique per rate group.
+              "originPostalCode": "A String", # Required. Shipping origin for this carrier rate.
+              "percentageAdjustment": "A String", # Optional. Multiplicative shipping rate modifier as a number in decimal notation. Can be negative. For example `"5.4"` increases the rate by 5.4%, `"-3"` decreases the rate by 3%.
+            },
+          ],
+          "mainTable": { # A table defining the rate group, when `single_value` is not expressive enough. # A table defining the rate group, when `single_value` is not expressive enough. Can only be set if `single_value` is not set.
+            "columnHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Headers of the table's columns. Optional: if not set then the table has only one dimension.
+              "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                    "A String",
+                  ],
+                },
+              ],
+              "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The price represented as a number and currency.
+                  "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                  "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                },
+              ],
+              "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The weight represented as the value in string and the unit.
+                  "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                  "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                },
+              ],
+            },
+            "name": "A String", # Name of the table. Required for subtables, ignored for the main table.
+            "rowHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Required. Headers of the table's rows.
+              "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                    "A String",
+                  ],
+                },
+              ],
+              "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The price represented as a number and currency.
+                  "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                  "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                },
+              ],
+              "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The weight represented as the value in string and the unit.
+                  "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                  "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                },
+              ],
+            },
+            "rows": [ # Required. The list of rows that constitute the table. Must have the same length as `row_headers`.
+              { # Include a list of cells.
+                "cells": [ # Required. The list of cells that constitute the row. Must have the same length as `columnHeaders` for two-dimensional tables, a length of 1 for one-dimensional tables.
+                  { # The single value of a rate group or the value of a rate group table's cell. Exactly one of `no_shipping`, `flat_rate`, `price_percentage`, `carrier_rateName`, `subtable_name` must be set.
+                    "carrierRate": "A String", # The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set.
+                    "flatRate": { # The price represented as a number and currency. # A flat rate. Can only be set if all other fields are not set.
+                      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                    },
+                    "noShipping": True or False, # If true, then the product can't be shipped. Must be true when set, can only be set if all other fields are not set.
+                    "pricePercentage": "A String", # A percentage of the price represented as a number in decimal notation (For example, `"5.4"`). Can only be set if all other fields are not set.
+                    "subtable": "A String", # The name of a subtable. Can only be set in table cells (For example, not for single values), and only if all other fields are not set.
+                  },
+                ],
+              },
+            ],
+          },
+          "name": "A String", # Optional. Name of the rate group. If set has to be unique within shipping service.
+          "singleValue": { # The single value of a rate group or the value of a rate group table's cell. Exactly one of `no_shipping`, `flat_rate`, `price_percentage`, `carrier_rateName`, `subtable_name` must be set. # The value of the rate group (For example flat rate $10). Can only be set if `main_table` and `subtables` are not set.
+            "carrierRate": "A String", # The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set.
+            "flatRate": { # The price represented as a number and currency. # A flat rate. Can only be set if all other fields are not set.
+              "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+              "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+            },
+            "noShipping": True or False, # If true, then the product can't be shipped. Must be true when set, can only be set if all other fields are not set.
+            "pricePercentage": "A String", # A percentage of the price represented as a number in decimal notation (For example, `"5.4"`). Can only be set if all other fields are not set.
+            "subtable": "A String", # The name of a subtable. Can only be set in table cells (For example, not for single values), and only if all other fields are not set.
+          },
+          "subtables": [ # Optional. A list of subtables referred to by `main_table`. Can only be set if `main_table` is set.
+            { # A table defining the rate group, when `single_value` is not expressive enough.
+              "columnHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Headers of the table's columns. Optional: if not set then the table has only one dimension.
+                "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                    "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                      "A String",
+                    ],
+                  },
+                ],
+                "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The price represented as a number and currency.
+                    "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                    "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                  },
+                ],
+                "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The weight represented as the value in string and the unit.
+                    "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                    "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                  },
+                ],
+              },
+              "name": "A String", # Name of the table. Required for subtables, ignored for the main table.
+              "rowHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Required. Headers of the table's rows.
+                "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                    "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                      "A String",
+                    ],
+                  },
+                ],
+                "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The price represented as a number and currency.
+                    "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                    "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                  },
+                ],
+                "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The weight represented as the value in string and the unit.
+                    "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                    "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                  },
+                ],
+              },
+              "rows": [ # Required. The list of rows that constitute the table. Must have the same length as `row_headers`.
+                { # Include a list of cells.
+                  "cells": [ # Required. The list of cells that constitute the row. Must have the same length as `columnHeaders` for two-dimensional tables, a length of 1 for one-dimensional tables.
+                    { # The single value of a rate group or the value of a rate group table's cell. Exactly one of `no_shipping`, `flat_rate`, `price_percentage`, `carrier_rateName`, `subtable_name` must be set.
+                      "carrierRate": "A String", # The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set.
+                      "flatRate": { # The price represented as a number and currency. # A flat rate. Can only be set if all other fields are not set.
+                        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                      },
+                      "noShipping": True or False, # If true, then the product can't be shipped. Must be true when set, can only be set if all other fields are not set.
+                      "pricePercentage": "A String", # A percentage of the price represented as a number in decimal notation (For example, `"5.4"`). Can only be set if all other fields are not set.
+                      "subtable": "A String", # The name of a subtable. Can only be set in table cells (For example, not for single values), and only if all other fields are not set.
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
+        },
+      ],
+      "serviceName": "A String", # Required. Free-form name of the service. Must be unique within target account.
+      "shipmentType": "A String", # Optional. Type of locations this service ships orders to.
+      "storeConfig": { # A list of stores your products are delivered from. This is only valid for the local delivery shipment type. # A list of stores your products are delivered from. This is only valid for the local delivery shipment type.
+        "cutoffConfig": { # Configs related to local delivery ends for the day. # Configs related to local delivery ends for the day.
+          "localCutoffTime": { # Time that local delivery ends for the day. # Time that local delivery ends for the day.
+            "hour": "A String", # Hour local delivery orders must be placed by to process the same day.
+            "minute": "A String", # Minute local delivery orders must be placed by to process the same day.
+          },
+          "noDeliveryPostCutoff": True or False, # Businesses can opt-out of showing n+1 day local delivery when they have a shipping service configured to n day local delivery. For example, if the shipping service defines same-day delivery, and it's past the cut-off, setting this field to `true` results in the calculated shipping service rate returning `NO_DELIVERY_POST_CUTOFF`. In the same example, setting this field to `false` results in the calculated shipping time being one day. This is only for local delivery.
+          "storeCloseOffsetHours": "A String", # Only valid with local delivery fulfillment. Represents cutoff time as the number of hours before store closing. Mutually exclusive with `local_cutoff_time`.
+        },
+        "serviceRadius": { # Maximum delivery radius. This is only required for the local delivery shipment type. # Maximum delivery radius. This is only required for the local delivery shipment type.
+          "unit": "A String", # Unit can differ based on country, it is parameterized to include miles and kilometers.
+          "value": "A String", # Integer value of distance.
+        },
+        "storeCodes": [ # Optional. A list of store codes that provide local delivery. If empty, then `all_stores` must be true.
+          "A String",
+        ],
+        "storeServiceType": "A String", # Indicates whether all stores, or selected stores, listed by this business provide local delivery.
+      },
+    },
+  ],
+  "warehouses": [ # Optional. A list of warehouses which can be referred to in `services`.
+    { # A fulfillment warehouse, which stores and handles inventory.
+      "businessDayConfig": { # Business days of the warehouse. # Business days of the warehouse. If not set, will be Monday to Friday by default.
+        "businessDays": [ # Required. Regular business days. May not be empty.
+          "A String",
+        ],
+      },
+      "cutoffTime": { # The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code. # Required. The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code.
+        "hour": 42, # Required. Hour of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Hour is based on the timezone of warehouse.
+        "minute": 42, # Required. Minute of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Minute is based on the timezone of warehouse.
+      },
+      "handlingDays": "A String", # Required. The number of days it takes for this warehouse to pack up and ship an item. This is on the warehouse level, but can be overridden on the offer level based on the attributes of an item.
+      "name": "A String", # Required. The name of the warehouse. Must be unique within account.
+      "shippingAddress": { # Shipping address of the warehouse. # Required. Shipping address of the warehouse.
+        "administrativeArea": "A String", # Required. Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+        "city": "A String", # Required. City, town or commune. May also include dependent localities or sublocalities (For example neighborhoods or suburbs).
+        "postalCode": "A String", # Required. Postal code or ZIP (For example "94043").
+        "regionCode": "A String", # Required. [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (For example "US").
+        "streetAddress": "A String", # Street-level part of the address. For example: `111w 31st Street`.
+      },
+    },
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The Merchant Center account's [shipping settings](https://support.google.com/merchants/answer/6069284). The `ShippingSettings` resource lets you retrieve and update the shipping settings of your advanced account and all its associated sub-accounts.
+  "etag": "A String", # Required. This field helps avoid async issues. It ensures that the shipping setting data doesn't change between the `get` call and the `insert` call. The user should follow these steps: 1. Set the etag field as an empty string for the initial shipping setting creation. 2. After the initial creation, call the `get` method to obtain an etag and the current shipping setting data before calling `insert`. 3. Modify the shipping setting information. 4. Call the `insert` method with the shipping setting information and the etag obtained in step 2. 5. If the shipping setting data changes between step 2 and step 4, the insert request will fail because the etag changes every time the shipping setting data changes. In this case, the user should repeat steps 2-4 with the new etag.
+  "name": "A String", # Identifier. The resource name of the shipping settings. Format: `accounts/{account}/shippingSettings`. For example, `accounts/123456/shippingSettings`.
+  "services": [ # Optional. The target account's list of services.
+    { # Shipping service.
+      "active": True or False, # Required. A boolean exposing the active status of the shipping service.
+      "currencyCode": "A String", # Required. The CLDR code of the currency to which this service applies. Must match that of the prices in rate groups.
+      "deliveryCountries": [ # Required. The CLDR territory code of the countries to which the service applies.
+        "A String",
+      ],
+      "deliveryTime": { # Time spent in various aspects from order to the delivery of the product. # Required. Time spent in various aspects from order to the delivery of the product.
+        "cutoffTime": { # Business days cutoff time definition. # Business days cutoff time definition. If not configured the cutoff time will be defaulted to 8AM PST.
+          "hour": 42, # Required. Hour of the cutoff time until which an order has to be placed to be processed in the same day.
+          "minute": 42, # Required. Minute of the cutoff time until which an order has to be placed to be processed in the same day.
+          "timeZone": "A String", # Required. [Timezone identifier](https://developers.google.com/adwords/api/docs/appendix/codes-formats#timezone-ids) For example "Europe/Zurich".
+        },
+        "handlingBusinessDayConfig": { # Business days of the warehouse. # The business days during which orders can be handled. If not provided, Monday to Friday business days will be assumed.
+          "businessDays": [ # Required. Regular business days. May not be empty.
+            "A String",
+          ],
+        },
+        "maxHandlingDays": 42, # Maximum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. Must be greater than or equal to `min_handling_days`. 'min_handling_days' and 'max_handling_days' should be either set or not set at the same time.
+        "maxTransitDays": 42, # Maximum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Must be greater than or equal to `min_transit_days`.
+        "minHandlingDays": 42, # Minimum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. 'min_handling_days' and 'max_handling_days' should be either set or not set at the same time.
+        "minTransitDays": 42, # Minimum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Either `min_transit_days`, `max_transit_days` or `transit_time_table` must be set, but not both.
+        "transitBusinessDayConfig": { # Business days of the warehouse. # The business days during which orders can be in-transit. If not provided, Monday to Friday business days will be assumed.
+          "businessDays": [ # Required. Regular business days. May not be empty.
+            "A String",
+          ],
+        },
+        "transitTimeTable": { # Transit time table, number of business days spent in transit based on row and column dimensions. Either `min_transit_days`, `max_transit_days` or `transit_time_table` can be set, but not both. # Transit time table, number of business days spent in transit based on row and column dimensions. Either `min_transit_days`, `max_transit_days` or `transit_time_table` can be set, but not both.
+          "postalCodeGroupNames": [ # Required. A list of region names Region.name . The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service.
+            "A String",
+          ],
+          "rows": [ # Required. If there's only one dimension set of `postal_code_group_names` or `transit_time_labels`, there are multiple rows each with one value for that dimension. If there are two dimensions, each row corresponds to a `postal_code_group_names`, and columns (values) to a `transit_time_labels`.
+            { # If there's only one dimension set of `postal_code_group_names` or `transit_time_labels`, there are multiple rows each with one value for that dimension. If there are two dimensions, each row corresponds to a `postal_code_group_names`, and columns (values) to a `transit_time_labels`.
+              "values": [ # Required. Transit time range (min-max) in business days.
+                { # Transit time range (min-max) in business days.
+                  "maxTransitDays": 42, # Must be greater than or equal to `min_transit_days`.
+                  "minTransitDays": 42, # Minimum transit time range in business days. 0 means same day delivery, 1 means next day delivery.
+                },
+              ],
+            },
+          ],
+          "transitTimeLabels": [ # Required. A list of transit time labels. The last value can be `"all other labels"`. Example: `["food", "electronics", "all other labels"]`.
+            "A String",
+          ],
+        },
+        "warehouseBasedDeliveryTimes": [ # Optional. Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the settings of the selected carrier. When set, no other transit time related field in delivery time should be set.
+          { # Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the settings of the selected carrier. When set, no other transit time related field in `delivery_time` should be set.
+            "carrier": "A String", # Required. Carrier, such as `"UPS"` or `"Fedex"`. [supported carriers](https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-and-us-only)
+            "carrierService": "A String", # Required. Carrier service, such as `"ground"` or `"2 days"`. The name of the service must be in the eddSupportedServices list.
+            "warehouse": "A String", # Required. Warehouse name. This should match warehouse.
+          },
+        ],
+      },
+      "loyaltyPrograms": [ # Optional. Loyalty programs that this shipping service is limited to.
+        { # [Loyalty program](https://support.google.com/merchants/answer/12922446) provided by a business.
+          "loyaltyProgramTiers": [ # Optional. Loyalty program tier of this shipping service.
+            { # Subset of a business's loyalty program.
+              "tierLabel": "A String", # The tier label [tier_label] sub-attribute differentiates offer level benefits between each tier. This value is also set in your program settings in Merchant Center, and is required for data source changes even if your loyalty program only has 1 tier.
+            },
+          ],
+          "programLabel": "A String", # This is the loyalty program label set in your loyalty program settings in Merchant Center. This sub-attribute allows Google to map your loyalty program to eligible offers.
+        },
+      ],
+      "minimumOrderValue": { # The price represented as a number and currency. # Optional. Minimum order value for this service. If set, indicates that customers will have to spend at least this amount. All prices within a service must have the same currency. Cannot be set together with `minimum_order_value_table`.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "minimumOrderValueTable": { # Table of per store minimum order values for the pickup fulfillment type. # Optional. Table of per store minimum order values for the pickup fulfillment type. Cannot be set together with `minimum_order_value`.
+        "storeCodeSetWithMovs": [ # Required. A list of store code sets sharing the same minimum order value (MOV). At least two sets are required and the last one must be empty, which signifies 'MOV for all other stores'. Each store code can only appear once across all the sets. All prices within a service must have the same currency.
+          { # A list of store code sets sharing the same minimum order value. At least two sets are required and the last one must be empty, which signifies 'MOV for all other stores'. Each store code can only appear once across all the sets. All prices within a service must have the same currency.
+            "storeCodes": [ # Optional. A list of unique store codes or empty for the catch all.
+              "A String",
+            ],
+            "value": { # The price represented as a number and currency. # The minimum order value for the given stores.
+              "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+              "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+            },
+          },
+        ],
+      },
+      "rateGroups": [ # Optional. Shipping rate group definitions. Only the last one is allowed to have an empty `applicable_shipping_labels`, which means "everything else". The other `applicable_shipping_labels` must not overlap.
+        { # Shipping rate group definitions. Only the last one is allowed to have an empty `applicable_shipping_labels`, which means "everything else". The other `applicable_shipping_labels` must not overlap.
+          "applicableShippingLabels": [ # Required. A list of [shipping labels](https://support.google.com/merchants/answer/6324504) defining the products to which this rate group applies to. This is a disjunction: only one of the labels has to match for the rate group to apply. May only be empty for the last rate group of a service.
+            "A String",
+          ],
+          "carrierRates": [ # Optional. A list of carrier rates that can be referred to by `main_table` or `single_value`.
+            { # A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported carrier services are defined in https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.
+              "carrier": "A String", # Required. Carrier service, such as `"UPS"` or `"Fedex"`.
+              "carrierService": "A String", # Required. Carrier service, such as `"ground"` or `"2 days"`.
+              "flatAdjustment": { # The price represented as a number and currency. # Optional. Additive shipping rate modifier. Can be negative. For example `{ "amount_micros": 1, "currency_code" : "USD" }` adds $1 to the rate, `{ "amount_micros": -3, "currency_code" : "USD" }` removes $3 from the rate.
+                "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+              },
+              "name": "A String", # Required. Name of the carrier rate. Must be unique per rate group.
+              "originPostalCode": "A String", # Required. Shipping origin for this carrier rate.
+              "percentageAdjustment": "A String", # Optional. Multiplicative shipping rate modifier as a number in decimal notation. Can be negative. For example `"5.4"` increases the rate by 5.4%, `"-3"` decreases the rate by 3%.
+            },
+          ],
+          "mainTable": { # A table defining the rate group, when `single_value` is not expressive enough. # A table defining the rate group, when `single_value` is not expressive enough. Can only be set if `single_value` is not set.
+            "columnHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Headers of the table's columns. Optional: if not set then the table has only one dimension.
+              "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                    "A String",
+                  ],
+                },
+              ],
+              "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The price represented as a number and currency.
+                  "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                  "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                },
+              ],
+              "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The weight represented as the value in string and the unit.
+                  "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                  "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                },
+              ],
+            },
+            "name": "A String", # Name of the table. Required for subtables, ignored for the main table.
+            "rowHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Required. Headers of the table's rows.
+              "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                    "A String",
+                  ],
+                },
+              ],
+              "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                "A String",
+              ],
+              "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The price represented as a number and currency.
+                  "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                  "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                },
+              ],
+              "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                { # The weight represented as the value in string and the unit.
+                  "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                  "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                },
+              ],
+            },
+            "rows": [ # Required. The list of rows that constitute the table. Must have the same length as `row_headers`.
+              { # Include a list of cells.
+                "cells": [ # Required. The list of cells that constitute the row. Must have the same length as `columnHeaders` for two-dimensional tables, a length of 1 for one-dimensional tables.
+                  { # The single value of a rate group or the value of a rate group table's cell. Exactly one of `no_shipping`, `flat_rate`, `price_percentage`, `carrier_rateName`, `subtable_name` must be set.
+                    "carrierRate": "A String", # The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set.
+                    "flatRate": { # The price represented as a number and currency. # A flat rate. Can only be set if all other fields are not set.
+                      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                    },
+                    "noShipping": True or False, # If true, then the product can't be shipped. Must be true when set, can only be set if all other fields are not set.
+                    "pricePercentage": "A String", # A percentage of the price represented as a number in decimal notation (For example, `"5.4"`). Can only be set if all other fields are not set.
+                    "subtable": "A String", # The name of a subtable. Can only be set in table cells (For example, not for single values), and only if all other fields are not set.
+                  },
+                ],
+              },
+            ],
+          },
+          "name": "A String", # Optional. Name of the rate group. If set has to be unique within shipping service.
+          "singleValue": { # The single value of a rate group or the value of a rate group table's cell. Exactly one of `no_shipping`, `flat_rate`, `price_percentage`, `carrier_rateName`, `subtable_name` must be set. # The value of the rate group (For example flat rate $10). Can only be set if `main_table` and `subtables` are not set.
+            "carrierRate": "A String", # The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set.
+            "flatRate": { # The price represented as a number and currency. # A flat rate. Can only be set if all other fields are not set.
+              "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+              "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+            },
+            "noShipping": True or False, # If true, then the product can't be shipped. Must be true when set, can only be set if all other fields are not set.
+            "pricePercentage": "A String", # A percentage of the price represented as a number in decimal notation (For example, `"5.4"`). Can only be set if all other fields are not set.
+            "subtable": "A String", # The name of a subtable. Can only be set in table cells (For example, not for single values), and only if all other fields are not set.
+          },
+          "subtables": [ # Optional. A list of subtables referred to by `main_table`. Can only be set if `main_table` is set.
+            { # A table defining the rate group, when `single_value` is not expressive enough.
+              "columnHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Headers of the table's columns. Optional: if not set then the table has only one dimension.
+                "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                    "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                      "A String",
+                    ],
+                  },
+                ],
+                "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The price represented as a number and currency.
+                    "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                    "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                  },
+                ],
+                "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The weight represented as the value in string and the unit.
+                    "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                    "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                  },
+                ],
+              },
+              "name": "A String", # Name of the table. Required for subtables, ignored for the main table.
+              "rowHeaders": { # A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set. # Required. Headers of the table's rows.
+                "locations": [ # Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                  { # A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.
+                    "locationIds": [ # Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).
+                      "A String",
+                    ],
+                  },
+                ],
+                "numberOfItems": [ # Required. A list of inclusive number of items upper bounds. The last value can be `"infinity"`. For example `["10", "50", "infinity"]` represents the headers "<= 10 items", "<= 50 items", and "> 50 items". Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "postalCodeGroupNames": [ # Required. A list of postal group names. The last value can be `"all other locations"`. Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.
+                  "A String",
+                ],
+                "prices": [ # Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]` represents the headers "<= $10", "<= $500", and "> $500". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The price represented as a number and currency.
+                    "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                    "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                  },
+                ],
+                "weights": [ # Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]` represents the headers "<= 10kg", "<= 50kg", and "> 50kg". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.
+                  { # The weight represented as the value in string and the unit.
+                    "amountMicros": "A String", # Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.
+                    "unit": "A String", # Required. The weight unit. Acceptable values are: kg and lb
+                  },
+                ],
+              },
+              "rows": [ # Required. The list of rows that constitute the table. Must have the same length as `row_headers`.
+                { # Include a list of cells.
+                  "cells": [ # Required. The list of cells that constitute the row. Must have the same length as `columnHeaders` for two-dimensional tables, a length of 1 for one-dimensional tables.
+                    { # The single value of a rate group or the value of a rate group table's cell. Exactly one of `no_shipping`, `flat_rate`, `price_percentage`, `carrier_rateName`, `subtable_name` must be set.
+                      "carrierRate": "A String", # The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set.
+                      "flatRate": { # The price represented as a number and currency. # A flat rate. Can only be set if all other fields are not set.
+                        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+                        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+                      },
+                      "noShipping": True or False, # If true, then the product can't be shipped. Must be true when set, can only be set if all other fields are not set.
+                      "pricePercentage": "A String", # A percentage of the price represented as a number in decimal notation (For example, `"5.4"`). Can only be set if all other fields are not set.
+                      "subtable": "A String", # The name of a subtable. Can only be set in table cells (For example, not for single values), and only if all other fields are not set.
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
+        },
+      ],
+      "serviceName": "A String", # Required. Free-form name of the service. Must be unique within target account.
+      "shipmentType": "A String", # Optional. Type of locations this service ships orders to.
+      "storeConfig": { # A list of stores your products are delivered from. This is only valid for the local delivery shipment type. # A list of stores your products are delivered from. This is only valid for the local delivery shipment type.
+        "cutoffConfig": { # Configs related to local delivery ends for the day. # Configs related to local delivery ends for the day.
+          "localCutoffTime": { # Time that local delivery ends for the day. # Time that local delivery ends for the day.
+            "hour": "A String", # Hour local delivery orders must be placed by to process the same day.
+            "minute": "A String", # Minute local delivery orders must be placed by to process the same day.
+          },
+          "noDeliveryPostCutoff": True or False, # Businesses can opt-out of showing n+1 day local delivery when they have a shipping service configured to n day local delivery. For example, if the shipping service defines same-day delivery, and it's past the cut-off, setting this field to `true` results in the calculated shipping service rate returning `NO_DELIVERY_POST_CUTOFF`. In the same example, setting this field to `false` results in the calculated shipping time being one day. This is only for local delivery.
+          "storeCloseOffsetHours": "A String", # Only valid with local delivery fulfillment. Represents cutoff time as the number of hours before store closing. Mutually exclusive with `local_cutoff_time`.
+        },
+        "serviceRadius": { # Maximum delivery radius. This is only required for the local delivery shipment type. # Maximum delivery radius. This is only required for the local delivery shipment type.
+          "unit": "A String", # Unit can differ based on country, it is parameterized to include miles and kilometers.
+          "value": "A String", # Integer value of distance.
+        },
+        "storeCodes": [ # Optional. A list of store codes that provide local delivery. If empty, then `all_stores` must be true.
+          "A String",
+        ],
+        "storeServiceType": "A String", # Indicates whether all stores, or selected stores, listed by this business provide local delivery.
+      },
+    },
+  ],
+  "warehouses": [ # Optional. A list of warehouses which can be referred to in `services`.
+    { # A fulfillment warehouse, which stores and handles inventory.
+      "businessDayConfig": { # Business days of the warehouse. # Business days of the warehouse. If not set, will be Monday to Friday by default.
+        "businessDays": [ # Required. Regular business days. May not be empty.
+          "A String",
+        ],
+      },
+      "cutoffTime": { # The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code. # Required. The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code.
+        "hour": 42, # Required. Hour of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Hour is based on the timezone of warehouse.
+        "minute": 42, # Required. Minute of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Minute is based on the timezone of warehouse.
+      },
+      "handlingDays": "A String", # Required. The number of days it takes for this warehouse to pack up and ship an item. This is on the warehouse level, but can be overridden on the offer level based on the attributes of an item.
+      "name": "A String", # Required. The name of the warehouse. Must be unique within account.
+      "shippingAddress": { # Shipping address of the warehouse. # Required. Shipping address of the warehouse.
+        "administrativeArea": "A String", # Required. Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+        "city": "A String", # Required. City, town or commune. May also include dependent localities or sublocalities (For example neighborhoods or suburbs).
+        "postalCode": "A String", # Required. Postal code or ZIP (For example "94043").
+        "regionCode": "A String", # Required. [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (For example "US").
+        "streetAddress": "A String", # Street-level part of the address. For example: `111w 31st Street`.
+      },
+    },
+  ],
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.termsOfServiceAgreementStates.html b/docs/dyn/merchantapi_accounts_v1.accounts.termsOfServiceAgreementStates.html
new file mode 100644
index 00000000000..aa7521ae4eb
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.termsOfServiceAgreementStates.html
@@ -0,0 +1,160 @@
+
+
+
+
Merchant API . accounts . termsOfServiceAgreementStates

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

+
Returns the state of a terms of service agreement.

+

+  retrieveForApplication(parent, x__xgafv=None)

+
Retrieves the state of the agreement for the application terms of service. Application terms of service covers permissions related to the usage of data provided through Merchant Center, CSS Center, Manufacturer Center, and more.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    get(name, x__xgafv=None)
+  
Returns the state of a terms of service agreement.
+
+Args:
+  name: string, Required. The resource name of the terms of service version. Format: `accounts/{account}/termsOfServiceAgreementStates/{identifier}` The identifier format is: `{TermsOfServiceKind}-{country}` (required)
+  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 the agreement state for a given account and terms of service kind. The state is as follows: * If the business has accepted a terms of service, `accepted` will be populated, otherwise it will be empty * If the business must sign a terms of service, `required` will be populated, otherwise it will be empty. Note that both `required` and `accepted` can be present. In this case the `accepted` terms of services will have an expiration date set in the `valid_until` field. The `required` terms of services need to be accepted before `valid_until` in order for the account to continue having a valid agreement. When accepting new terms of services we expect third-party providers to display the text associated with the given terms of service agreement (the url to the file containing the text is added in the Required message below as `tos_file_uri`). The actual acceptance of the terms of service is done by calling accept on the `TermsOfService` resource. `valid_until` field. The `required` terms of services need to be accepted before `valid_until` in order for the account to continue having a valid agreement. When accepting new terms of services, we expect third-party providers to display the text associated with the given terms of service agreement (the url to the file containing the text is added in the Required message below as `tos_file_uri`. The actual acceptance of the terms of service is done by calling accept on the `TermsOfService` resource.
+  "accepted": { # Describes the [accepted terms of service](https://developers.google.com/merchant/api/guides/accounts/create-and-configure#accept_the_merchant_center_terms_of_service). # Optional. The accepted terms of service of this kind and for the associated region_code
+    "acceptedBy": "A String", # Required. The account where the acceptance was recorded. This can be the account itself or, in the case of subaccounts, the advanced account.
+    "termsOfService": "A String", # Required. The accepted termsOfService.
+    "validUntil": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Optional. When set, it states that the accepted `TermsOfService` is only valid until the end of this date (in UTC). A new one must be accepted before then. The information of the required `TermsOfService` is found in the `Required` message.
+      "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+      "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+      "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+    },
+  },
+  "name": "A String", # Identifier. The resource name of the terms of service version. Format: `accounts/{account}/termsOfServiceAgreementState/{identifier}` The identifier format is: `{TermsOfServiceKind}-{country}` For example, an identifier could be: `MERCHANT_CENTER-EU` or `MERCHANT_CENTER-US`.
+  "regionCode": "A String", # Required. Region code as defined by https://cldr.unicode.org/. This is the country the current state applies to.
+  "required": { # Describes the terms of service which are required to be accepted. # Optional. The required terms of service
+    "termsOfService": "A String", # Required. The `TermsOfService` that need to be accepted.
+    "tosFileUri": "A String", # Required. Full URL to the terms of service file. This field is the same as `TermsOfService.file_uri`, it is added here for convenience only.
+  },
+  "termsOfServiceKind": "A String", # Required. Terms of Service kind associated with the particular version.
+}

+

+
+

+    retrieveForApplication(parent, x__xgafv=None)
+  
Retrieves the state of the agreement for the application terms of service. Application terms of service covers permissions related to the usage of data provided through Merchant Center, CSS Center, Manufacturer Center, and more.
+
+Args:
+  parent: string, Required. The account for which to get a TermsOfServiceAgreementState Format: `accounts/{account}` (required)
+  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 the agreement state for a given account and terms of service kind. The state is as follows: * If the business has accepted a terms of service, `accepted` will be populated, otherwise it will be empty * If the business must sign a terms of service, `required` will be populated, otherwise it will be empty. Note that both `required` and `accepted` can be present. In this case the `accepted` terms of services will have an expiration date set in the `valid_until` field. The `required` terms of services need to be accepted before `valid_until` in order for the account to continue having a valid agreement. When accepting new terms of services we expect third-party providers to display the text associated with the given terms of service agreement (the url to the file containing the text is added in the Required message below as `tos_file_uri`). The actual acceptance of the terms of service is done by calling accept on the `TermsOfService` resource. `valid_until` field. The `required` terms of services need to be accepted before `valid_until` in order for the account to continue having a valid agreement. When accepting new terms of services, we expect third-party providers to display the text associated with the given terms of service agreement (the url to the file containing the text is added in the Required message below as `tos_file_uri`. The actual acceptance of the terms of service is done by calling accept on the `TermsOfService` resource.
+  "accepted": { # Describes the [accepted terms of service](https://developers.google.com/merchant/api/guides/accounts/create-and-configure#accept_the_merchant_center_terms_of_service). # Optional. The accepted terms of service of this kind and for the associated region_code
+    "acceptedBy": "A String", # Required. The account where the acceptance was recorded. This can be the account itself or, in the case of subaccounts, the advanced account.
+    "termsOfService": "A String", # Required. The accepted termsOfService.
+    "validUntil": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Optional. When set, it states that the accepted `TermsOfService` is only valid until the end of this date (in UTC). A new one must be accepted before then. The information of the required `TermsOfService` is found in the `Required` message.
+      "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+      "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+      "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+    },
+  },
+  "name": "A String", # Identifier. The resource name of the terms of service version. Format: `accounts/{account}/termsOfServiceAgreementState/{identifier}` The identifier format is: `{TermsOfServiceKind}-{country}` For example, an identifier could be: `MERCHANT_CENTER-EU` or `MERCHANT_CENTER-US`.
+  "regionCode": "A String", # Required. Region code as defined by https://cldr.unicode.org/. This is the country the current state applies to.
+  "required": { # Describes the terms of service which are required to be accepted. # Optional. The required terms of service
+    "termsOfService": "A String", # Required. The `TermsOfService` that need to be accepted.
+    "tosFileUri": "A String", # Required. Full URL to the terms of service file. This field is the same as `TermsOfService.file_uri`, it is added here for convenience only.
+  },
+  "termsOfServiceKind": "A String", # Required. Terms of Service kind associated with the particular version.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.users.html b/docs/dyn/merchantapi_accounts_v1.accounts.users.html
new file mode 100644
index 00000000000..f3aac4d59a6
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.users.html
@@ -0,0 +1,259 @@
+
+
+
+
Merchant API . accounts . users

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Creates a Merchant Center account user. Executing this method requires admin access.

+

+  delete(name, x__xgafv=None)

+
Deletes a Merchant Center account user. Executing this method requires admin access. The user to be deleted can't be the last admin user of that account. Also a user is protected from deletion if it is managed by Business Manager"

+

+  get(name, x__xgafv=None)

+
Retrieves a Merchant Center account user.

+

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

+
Lists all users of a Merchant Center account.

+

+  list_next()

+
Retrieves the next page of results.

+

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

+
Updates a Merchant Center account user. Executing this method requires admin access.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, userId=None, x__xgafv=None)
+  
Creates a Merchant Center account user. Executing this method requires admin access.
+
+Args:
+  parent: string, Required. The resource name of the account for which a user will be created. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The `User` message represents a user associated with a Merchant Center account. It is used to manage user permissions and access rights within the account. For more information, see [Frequently asked questions about people and access levels](//support.google.com/merchants/answer/12160472).
+  "accessRights": [ # Required. The [access rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes) the user has.
+    "A String",
+  ],
+  "name": "A String", # Identifier. The resource name of the user. Format: `accounts/{account}/user/{email}` Use `me` to refer to your own email address, for example `accounts/{account}/users/me`.
+  "state": "A String", # Output only. The state of the user.
+}
+
+  userId: string, Required. The email address of the user (for example, `john.doe@gmail.com`).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `User` message represents a user associated with a Merchant Center account. It is used to manage user permissions and access rights within the account. For more information, see [Frequently asked questions about people and access levels](//support.google.com/merchants/answer/12160472).
+  "accessRights": [ # Required. The [access rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes) the user has.
+    "A String",
+  ],
+  "name": "A String", # Identifier. The resource name of the user. Format: `accounts/{account}/user/{email}` Use `me` to refer to your own email address, for example `accounts/{account}/users/me`.
+  "state": "A String", # Output only. The state of the user.
+}

+

+
+

+    delete(name, x__xgafv=None)
+  
Deletes a Merchant Center account user. Executing this method requires admin access. The user to be deleted can't be the last admin user of that account. Also a user is protected from deletion if it is managed by Business Manager"
+
+Args:
+  name: string, Required. The name of the user to delete. Format: `accounts/{account}/users/{email}` It is also possible to delete the user corresponding to the caller by using `me` rather than an email address as in `accounts/{account}/users/me`. (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)
+  
Retrieves a Merchant Center account user.
+
+Args:
+  name: string, Required. The name of the user to retrieve. Format: `accounts/{account}/users/{email}` It is also possible to retrieve the user corresponding to the caller by using `me` rather than an email address as in `accounts/{account}/users/me`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `User` message represents a user associated with a Merchant Center account. It is used to manage user permissions and access rights within the account. For more information, see [Frequently asked questions about people and access levels](//support.google.com/merchants/answer/12160472).
+  "accessRights": [ # Required. The [access rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes) the user has.
+    "A String",
+  ],
+  "name": "A String", # Identifier. The resource name of the user. Format: `accounts/{account}/user/{email}` Use `me` to refer to your own email address, for example `accounts/{account}/users/me`.
+  "state": "A String", # Output only. The state of the user.
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists all users of a Merchant Center account.
+
+Args:
+  parent: string, Required. The parent, which owns this collection of users. Format: `accounts/{account}` (required)
+  pageSize: integer, Optional. The maximum number of users to return. The service may return fewer than this value. If unspecified, at most 50 users will be returned. The maximum value is 100; values above 100 will be coerced to 100
+  pageToken: string, Optional. A page token, received from a previous `ListUsers` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUsers` 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 the `ListUsers` method.
+  "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.
+  "users": [ # The users from the specified account.
+    { # The `User` message represents a user associated with a Merchant Center account. It is used to manage user permissions and access rights within the account. For more information, see [Frequently asked questions about people and access levels](//support.google.com/merchants/answer/12160472).
+      "accessRights": [ # Required. The [access rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes) the user has.
+        "A String",
+      ],
+      "name": "A String", # Identifier. The resource name of the user. Format: `accounts/{account}/user/{email}` Use `me` to refer to your own email address, for example `accounts/{account}/users/me`.
+      "state": "A String", # Output only. The state of the user.
+    },
+  ],
+}

+

+
+

+    list_next()
+  
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        

+

+
+

+    patch(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates a Merchant Center account user. Executing this method requires admin access.
+
+Args:
+  name: string, Identifier. The resource name of the user. Format: `accounts/{account}/user/{email}` Use `me` to refer to your own email address, for example `accounts/{account}/users/me`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The `User` message represents a user associated with a Merchant Center account. It is used to manage user permissions and access rights within the account. For more information, see [Frequently asked questions about people and access levels](//support.google.com/merchants/answer/12160472).
+  "accessRights": [ # Required. The [access rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes) the user has.
+    "A String",
+  ],
+  "name": "A String", # Identifier. The resource name of the user. Format: `accounts/{account}/user/{email}` Use `me` to refer to your own email address, for example `accounts/{account}/users/me`.
+  "state": "A String", # Output only. The state of the user.
+}
+
+  updateMask: string, Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `access_rights`
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `User` message represents a user associated with a Merchant Center account. It is used to manage user permissions and access rights within the account. For more information, see [Frequently asked questions about people and access levels](//support.google.com/merchants/answer/12160472).
+  "accessRights": [ # Required. The [access rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes) the user has.
+    "A String",
+  ],
+  "name": "A String", # Identifier. The resource name of the user. Format: `accounts/{account}/user/{email}` Use `me` to refer to your own email address, for example `accounts/{account}/users/me`.
+  "state": "A String", # Output only. The state of the user.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.html b/docs/dyn/merchantapi_accounts_v1.html
new file mode 100644
index 00000000000..4cd0c79d485
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.html
@@ -0,0 +1,116 @@
+
+
+
+
Merchant API

+
Instance Methods

+

+  accounts()
+

+
Returns the accounts Resource.

+
+

+  termsOfService()
+

+
Returns the termsOfService Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  new_batch_http_request()

+
Create a BatchHttpRequest object based on the discovery document.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    new_batch_http_request()
+  
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1.termsOfService.html b/docs/dyn/merchantapi_accounts_v1.termsOfService.html
new file mode 100644
index 00000000000..dde5331d74e
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1.termsOfService.html
@@ -0,0 +1,183 @@
+
+
+
+
Merchant API . termsOfService

+
Instance Methods

+

+  accept(name, account=None, regionCode=None, x__xgafv=None)

+
Accepts a `TermsOfService`. Executing this method requires admin access.

+

+  close()

+
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

+
Retrieves the `TermsOfService` associated with the provided version.

+

+  retrieveLatest(kind=None, regionCode=None, x__xgafv=None)

+
Retrieves the latest version of the `TermsOfService` for a given `kind` and `region_code`.

+
Method Details

+

+    accept(name, account=None, regionCode=None, x__xgafv=None)
+  
Accepts a `TermsOfService`. Executing this method requires admin access.
+
+Args:
+  name: string, Required. The resource name of the terms of service version. Format: `termsOfService/{version}` (required)
+  account: string, Required. The account for which to accept the ToS. Format: `accounts/{account}`
+  regionCode: string, Required. Region code as defined by [CLDR](https://cldr.unicode.org/). This is either a country when the ToS applies specifically to that country or 001 when it applies globally.
+  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 `AcceptTermsOfService` method.
+  "termsOfServiceAgreementState": { # This resource represents the agreement state for a given account and terms of service kind. The state is as follows: * If the business has accepted a terms of service, `accepted` will be populated, otherwise it will be empty * If the business must sign a terms of service, `required` will be populated, otherwise it will be empty. Note that both `required` and `accepted` can be present. In this case the `accepted` terms of services will have an expiration date set in the `valid_until` field. The `required` terms of services need to be accepted before `valid_until` in order for the account to continue having a valid agreement. When accepting new terms of services we expect third-party providers to display the text associated with the given terms of service agreement (the url to the file containing the text is added in the Required message below as `tos_file_uri`). The actual acceptance of the terms of service is done by calling accept on the `TermsOfService` resource. `valid_until` field. The `required` terms of services need to be accepted before `valid_until` in order for the account to continue having a valid agreement. When accepting new terms of services, we expect third-party providers to display the text associated with the given terms of service agreement (the url to the file containing the text is added in the Required message below as `tos_file_uri`. The actual acceptance of the terms of service is done by calling accept on the `TermsOfService` resource. # The agreement state after accepting the ToS.
+    "accepted": { # Describes the [accepted terms of service](https://developers.google.com/merchant/api/guides/accounts/create-and-configure#accept_the_merchant_center_terms_of_service). # Optional. The accepted terms of service of this kind and for the associated region_code
+      "acceptedBy": "A String", # Required. The account where the acceptance was recorded. This can be the account itself or, in the case of subaccounts, the advanced account.
+      "termsOfService": "A String", # Required. The accepted termsOfService.
+      "validUntil": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Optional. When set, it states that the accepted `TermsOfService` is only valid until the end of this date (in UTC). A new one must be accepted before then. The information of the required `TermsOfService` is found in the `Required` message.
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+    },
+    "name": "A String", # Identifier. The resource name of the terms of service version. Format: `accounts/{account}/termsOfServiceAgreementState/{identifier}` The identifier format is: `{TermsOfServiceKind}-{country}` For example, an identifier could be: `MERCHANT_CENTER-EU` or `MERCHANT_CENTER-US`.
+    "regionCode": "A String", # Required. Region code as defined by https://cldr.unicode.org/. This is the country the current state applies to.
+    "required": { # Describes the terms of service which are required to be accepted. # Optional. The required terms of service
+      "termsOfService": "A String", # Required. The `TermsOfService` that need to be accepted.
+      "tosFileUri": "A String", # Required. Full URL to the terms of service file. This field is the same as `TermsOfService.file_uri`, it is added here for convenience only.
+    },
+    "termsOfServiceKind": "A String", # Required. Terms of Service kind associated with the particular version.
+  },
+}

+

+
+

+    close()
+  
Close httplib2 connections.

+

+
+

+    get(name, x__xgafv=None)
+  
Retrieves the `TermsOfService` associated with the provided version.
+
+Args:
+  name: string, Required. The resource name of the terms of service version. Format: `termsOfService/{version}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `TermsOfService` message represents a specific version of the terms of service that merchants must accept to access certain features or services. For more information, see [Terms of Service](https://support.google.com/merchants/answer/160173). This message is important for the onboarding process, ensuring that merchants agree to the necessary legal agreements for using the service. Merchants can retrieve the latest terms of service for a given `kind` and `region` through `RetrieveLatestTermsOfService`, and accept them as required through `AcceptTermsOfService`.
+  "external": True or False, # Whether this terms of service version is external. External terms of service versions can only be agreed through external processes and not directly by the merchant through UI or API.
+  "fileUri": "A String", # URI for terms of service file that needs to be displayed to signing users.
+  "kind": "A String", # The Kind this terms of service version applies to.
+  "name": "A String", # Identifier. The resource name of the terms of service version. Format: `termsOfService/{version}`
+  "regionCode": "A String", # Region code as defined by [CLDR](https://cldr.unicode.org/). This is either a country where the ToS applies specifically to that country or `001` when the same `TermsOfService` can be signed in any country. However note that when signing a ToS that applies globally we still expect that a specific country is provided (this should be merchant business country or program country of participation).
+}

+

+
+

+    retrieveLatest(kind=None, regionCode=None, x__xgafv=None)
+  
Retrieves the latest version of the `TermsOfService` for a given `kind` and `region_code`.
+
+Args:
+  kind: string, Required. The Kind this terms of service version applies to.
+    Allowed values
+      TERMS_OF_SERVICE_KIND_UNSPECIFIED - Default value. This value is unused.
+      MERCHANT_CENTER - Merchant Center application.
+  regionCode: string, Required. Region code as defined by [CLDR](https://cldr.unicode.org/). This is either a country when the ToS applies specifically to that country or 001 when it applies globally.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The `TermsOfService` message represents a specific version of the terms of service that merchants must accept to access certain features or services. For more information, see [Terms of Service](https://support.google.com/merchants/answer/160173). This message is important for the onboarding process, ensuring that merchants agree to the necessary legal agreements for using the service. Merchants can retrieve the latest terms of service for a given `kind` and `region` through `RetrieveLatestTermsOfService`, and accept them as required through `AcceptTermsOfService`.
+  "external": True or False, # Whether this terms of service version is external. External terms of service versions can only be agreed through external processes and not directly by the merchant through UI or API.
+  "fileUri": "A String", # URI for terms of service file that needs to be displayed to signing users.
+  "kind": "A String", # The Kind this terms of service version applies to.
+  "name": "A String", # Identifier. The resource name of the terms of service version. Format: `termsOfService/{version}`
+  "regionCode": "A String", # Region code as defined by [CLDR](https://cldr.unicode.org/). This is either a country where the ToS applies specifically to that country or `001` when the same `TermsOfService` can be signed in any country. However note that when signing a ToS that applies globally we still expect that a specific country is provided (this should be merchant business country or program country of participation).
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.omnichannelSettings.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.omnichannelSettings.html
index 9b0c17f3b06..a8c1514043b 100644
--- a/docs/dyn/merchantapi_accounts_v1beta.accounts.omnichannelSettings.html
+++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.omnichannelSettings.html
@@ -116,7 +116,7 @@ 
Method Details

     The object takes the form of:
 
 { # Collection of information related to the omnichannel settings of a merchant.
-  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
     "state": "A String", # Output only. The state of the URI.
     "uri": "A String", # Required. The about page URI.
   },
@@ -124,7 +124,7 @@ 
Method Details

     "state": "A String", # Output only. The state of the in-stock serving.
     "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
   },
-  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
     "contact": "A String", # Required. The name of the contact for the inventory verification process.
     "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
     "contactState": "A String", # Output only. The state of the contact verification.
@@ -137,7 +137,7 @@ 
Method Details

   },
   "lsfType": "A String", # Required. The Local Store Front type for this country.
   "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
-  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?hl=en&ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
     "state": "A String", # Output only. The state of the URI.
     "uri": "A String", # Required. The on display to order (ODO) policy URI.
   },
@@ -157,7 +157,7 @@ 
Method Details

   An object of the form:
 
     { # Collection of information related to the omnichannel settings of a merchant.
-  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
     "state": "A String", # Output only. The state of the URI.
     "uri": "A String", # Required. The about page URI.
   },
@@ -165,7 +165,7 @@ 
Method Details

     "state": "A String", # Output only. The state of the in-stock serving.
     "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
   },
-  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
     "contact": "A String", # Required. The name of the contact for the inventory verification process.
     "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
     "contactState": "A String", # Output only. The state of the contact verification.
@@ -178,7 +178,7 @@ 
Method Details

   },
   "lsfType": "A String", # Required. The Local Store Front type for this country.
   "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
-  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?hl=en&ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
     "state": "A String", # Output only. The state of the URI.
     "uri": "A String", # Required. The on display to order (ODO) policy URI.
   },
@@ -205,7 +205,7 @@ 
Method Details

   An object of the form:
 
     { # Collection of information related to the omnichannel settings of a merchant.
-  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
     "state": "A String", # Output only. The state of the URI.
     "uri": "A String", # Required. The about page URI.
   },
@@ -213,7 +213,7 @@ 
Method Details

     "state": "A String", # Output only. The state of the in-stock serving.
     "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
   },
-  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
     "contact": "A String", # Required. The name of the contact for the inventory verification process.
     "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
     "contactState": "A String", # Output only. The state of the contact verification.
@@ -226,7 +226,7 @@ 
Method Details

   },
   "lsfType": "A String", # Required. The Local Store Front type for this country.
   "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
-  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?hl=en&ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
     "state": "A String", # Output only. The state of the URI.
     "uri": "A String", # Required. The on display to order (ODO) policy URI.
   },
@@ -258,7 +258,7 @@ 
Method Details

   "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.
   "omnichannelSettings": [ # The omnichannel settings from the specified merchant.
     { # Collection of information related to the omnichannel settings of a merchant.
-      "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+      "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
         "state": "A String", # Output only. The state of the URI.
         "uri": "A String", # Required. The about page URI.
       },
@@ -266,7 +266,7 @@ 
Method Details

         "state": "A String", # Output only. The state of the in-stock serving.
         "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
       },
-      "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+      "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
         "contact": "A String", # Required. The name of the contact for the inventory verification process.
         "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
         "contactState": "A String", # Output only. The state of the contact verification.
@@ -279,7 +279,7 @@ 
Method Details

       },
       "lsfType": "A String", # Required. The Local Store Front type for this country.
       "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
-      "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?hl=en&ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+      "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
         "state": "A String", # Output only. The state of the URI.
         "uri": "A String", # Required. The on display to order (ODO) policy URI.
       },
@@ -317,7 +317,7 @@ 
Method Details

     The object takes the form of:
 
 { # Collection of information related to the omnichannel settings of a merchant.
-  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
     "state": "A String", # Output only. The state of the URI.
     "uri": "A String", # Required. The about page URI.
   },
@@ -325,7 +325,7 @@ 
Method Details

     "state": "A String", # Output only. The state of the in-stock serving.
     "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
   },
-  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
     "contact": "A String", # Required. The name of the contact for the inventory verification process.
     "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
     "contactState": "A String", # Output only. The state of the contact verification.
@@ -338,7 +338,7 @@ 
Method Details

   },
   "lsfType": "A String", # Required. The Local Store Front type for this country.
   "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
-  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?hl=en&ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
     "state": "A String", # Output only. The state of the URI.
     "uri": "A String", # Required. The on display to order (ODO) policy URI.
   },
@@ -359,7 +359,7 @@ 
Method Details

   An object of the form:
 
     { # Collection of information related to the omnichannel settings of a merchant.
-  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+  "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
     "state": "A String", # Output only. The state of the URI.
     "uri": "A String", # Required. The about page URI.
   },
@@ -367,7 +367,7 @@ 
Method Details

     "state": "A String", # Output only. The state of the in-stock serving.
     "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
   },
-  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+  "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
     "contact": "A String", # Required. The name of the contact for the inventory verification process.
     "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
     "contactState": "A String", # Output only. The state of the contact verification.
@@ -380,7 +380,7 @@ 
Method Details

   },
   "lsfType": "A String", # Required. The Local Store Front type for this country.
   "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
-  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?hl=en&ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+  "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
     "state": "A String", # Output only. The state of the URI.
     "uri": "A String", # Required. The on display to order (ODO) policy URI.
   },
@@ -414,7 +414,7 @@ 
Method Details

 
     { # Response message for the RequestInventoryVerification method.
   "omnichannelSetting": { # Collection of information related to the omnichannel settings of a merchant. # The omnichannel setting that was updated.
-    "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
+    "about": { # Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)). # Optional. The about page URI and state for this country.
       "state": "A String", # Output only. The state of the URI.
       "uri": "A String", # Required. The about page URI.
     },
@@ -422,7 +422,7 @@ 
Method Details

       "state": "A String", # Output only. The state of the in-stock serving.
       "uri": "A String", # Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.
     },
-    "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
+    "inventoryVerification": { # Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC). # Optional. The inventory verification contact and state for this country.
       "contact": "A String", # Required. The name of the contact for the inventory verification process.
       "contactEmail": "A String", # Required. The email address of the contact for the inventory verification process.
       "contactState": "A String", # Output only. The state of the contact verification.
@@ -435,7 +435,7 @@ 
Method Details

     },
     "lsfType": "A String", # Required. The Local Store Front type for this country.
     "name": "A String", # Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`
-    "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?hl=en&ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
+    "odo": { # Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)). # Optional. The On Display to Order (ODO) policy URI and state for this country.
       "state": "A String", # Output only. The state of the URI.
       "uri": "A String", # Required. The on display to order (ODO) policy URI.
     },
diff --git a/docs/dyn/merchantapi_conversions_v1.accounts.conversionSources.html b/docs/dyn/merchantapi_conversions_v1.accounts.conversionSources.html
new file mode 100644
index 00000000000..3c1bfa6737c
--- /dev/null
+++ b/docs/dyn/merchantapi_conversions_v1.accounts.conversionSources.html
@@ -0,0 +1,487 @@
+
+
+
+
Merchant API . accounts . conversionSources

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Creates a new conversion source.

+

+  delete(name, x__xgafv=None)

+
Archives an existing conversion source. If the conversion source is a Merchant Center Destination, it will be recoverable for 30 days. If the conversion source is a Google Analytics Link, it will be deleted immediately and can be restored by creating a new one.

+

+  get(name, x__xgafv=None)

+
Fetches a conversion source.

+

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

+
Retrieves the list of conversion sources the caller has access to.

+

+  list_next()

+
Retrieves the next page of results.

+

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

+
Updates information of an existing conversion source. Available only for Merchant Center Destination conversion sources.

+

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

+
Re-enables an archived conversion source. Only Available for Merchant Center Destination conversion sources.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, x__xgafv=None)
+  
Creates a new conversion source.
+
+Args:
+  parent: string, Required. The merchant account that will own the new conversion source. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a conversion source owned by a Merchant account. A merchant account can have up to 200 conversion sources.
+  "controller": "A String", # Output only. Controller of the conversion source.
+  "expireTime": "A String", # Output only. The time when an archived conversion source becomes permanently deleted and is no longer available to undelete.
+  "googleAnalyticsLink": { # "Google Analytics Link" sources can be used to get conversion data from an existing Google Analytics property into the linked Merchant Center account. # Immutable. Conversion Source of type "Link to Google Analytics Property".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Output only. Attribution settings for the linked Google Analytics property.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "property": "A String", # Output only. Name of the Google Analytics property the merchant is linked to.
+    "propertyId": "A String", # Required. Immutable. ID of the Google Analytics property the merchant is linked to.
+  },
+  "merchantCenterDestination": { # "Merchant Center Destination" sources can be used to send conversion events from an online store using a Google tag directly to a Merchant Center account where the source is created. # Conversion Source of type "Merchant Center Tag Destination".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Required. Attribution settings used for the Merchant Center Destination.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "currencyCode": "A String", # Required. Three-letter currency code (ISO 4217). The currency code defines in which currency the conversions sent to this destination will be reported in Merchant Center.
+    "destination": "A String", # Output only. Merchant Center Destination ID.
+    "displayName": "A String", # Required. Merchant-specified display name for the destination. This is the name that identifies the conversion source within the Merchant Center UI. The maximum length is 64 characters.
+  },
+  "name": "A String", # Output only. Identifier. Generated by the Content API upon creation of a new `ConversionSource`. Format: `[a-z]{4}:.+` The four characters before the colon represent the type of conversion source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: * `galk`: For GoogleAnalyticsLink sources. * `mcdn`: For MerchantCenterDestination sources.
+  "state": "A String", # Output only. Current state of this conversion source. Can't be edited through the API.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a conversion source owned by a Merchant account. A merchant account can have up to 200 conversion sources.
+  "controller": "A String", # Output only. Controller of the conversion source.
+  "expireTime": "A String", # Output only. The time when an archived conversion source becomes permanently deleted and is no longer available to undelete.
+  "googleAnalyticsLink": { # "Google Analytics Link" sources can be used to get conversion data from an existing Google Analytics property into the linked Merchant Center account. # Immutable. Conversion Source of type "Link to Google Analytics Property".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Output only. Attribution settings for the linked Google Analytics property.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "property": "A String", # Output only. Name of the Google Analytics property the merchant is linked to.
+    "propertyId": "A String", # Required. Immutable. ID of the Google Analytics property the merchant is linked to.
+  },
+  "merchantCenterDestination": { # "Merchant Center Destination" sources can be used to send conversion events from an online store using a Google tag directly to a Merchant Center account where the source is created. # Conversion Source of type "Merchant Center Tag Destination".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Required. Attribution settings used for the Merchant Center Destination.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "currencyCode": "A String", # Required. Three-letter currency code (ISO 4217). The currency code defines in which currency the conversions sent to this destination will be reported in Merchant Center.
+    "destination": "A String", # Output only. Merchant Center Destination ID.
+    "displayName": "A String", # Required. Merchant-specified display name for the destination. This is the name that identifies the conversion source within the Merchant Center UI. The maximum length is 64 characters.
+  },
+  "name": "A String", # Output only. Identifier. Generated by the Content API upon creation of a new `ConversionSource`. Format: `[a-z]{4}:.+` The four characters before the colon represent the type of conversion source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: * `galk`: For GoogleAnalyticsLink sources. * `mcdn`: For MerchantCenterDestination sources.
+  "state": "A String", # Output only. Current state of this conversion source. Can't be edited through the API.
+}

+

+
+

+    delete(name, x__xgafv=None)
+  
Archives an existing conversion source. If the conversion source is a Merchant Center Destination, it will be recoverable for 30 days. If the conversion source is a Google Analytics Link, it will be deleted immediately and can be restored by creating a new one.
+
+Args:
+  name: string, Required. The name of the conversion source to be deleted. Format: `accounts/{account}/conversionSources/{conversion_source}` (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)
+  
Fetches a conversion source.
+
+Args:
+  name: string, Required. The name of the conversion source to be fetched. Format: `accounts/{account}/conversionSources/{conversion_source}` (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 conversion source owned by a Merchant account. A merchant account can have up to 200 conversion sources.
+  "controller": "A String", # Output only. Controller of the conversion source.
+  "expireTime": "A String", # Output only. The time when an archived conversion source becomes permanently deleted and is no longer available to undelete.
+  "googleAnalyticsLink": { # "Google Analytics Link" sources can be used to get conversion data from an existing Google Analytics property into the linked Merchant Center account. # Immutable. Conversion Source of type "Link to Google Analytics Property".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Output only. Attribution settings for the linked Google Analytics property.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "property": "A String", # Output only. Name of the Google Analytics property the merchant is linked to.
+    "propertyId": "A String", # Required. Immutable. ID of the Google Analytics property the merchant is linked to.
+  },
+  "merchantCenterDestination": { # "Merchant Center Destination" sources can be used to send conversion events from an online store using a Google tag directly to a Merchant Center account where the source is created. # Conversion Source of type "Merchant Center Tag Destination".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Required. Attribution settings used for the Merchant Center Destination.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "currencyCode": "A String", # Required. Three-letter currency code (ISO 4217). The currency code defines in which currency the conversions sent to this destination will be reported in Merchant Center.
+    "destination": "A String", # Output only. Merchant Center Destination ID.
+    "displayName": "A String", # Required. Merchant-specified display name for the destination. This is the name that identifies the conversion source within the Merchant Center UI. The maximum length is 64 characters.
+  },
+  "name": "A String", # Output only. Identifier. Generated by the Content API upon creation of a new `ConversionSource`. Format: `[a-z]{4}:.+` The four characters before the colon represent the type of conversion source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: * `galk`: For GoogleAnalyticsLink sources. * `mcdn`: For MerchantCenterDestination sources.
+  "state": "A String", # Output only. Current state of this conversion source. Can't be edited through the API.
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)
+  
Retrieves the list of conversion sources the caller has access to.
+
+Args:
+  parent: string, Required. The merchant account who owns the collection of conversion sources. Format: `accounts/{account}` (required)
+  pageSize: integer, Optional. The maximum number of conversion sources to return in a page. If no `page_size` is specified, `100` is used as the default value. The maximum value is `200`. Values above `200` will be coerced to `200`. Regardless of pagination, at most `200` conversion sources are returned in total.
+  pageToken: string, Optional. Page token.
+  showDeleted: boolean, Optional. Show deleted (archived) conversion sources. By default, deleted conversion sources are not returned.
+  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 ListConversionSources method.
+  "conversionSources": [ # List of conversion sources.
+    { # Represents a conversion source owned by a Merchant account. A merchant account can have up to 200 conversion sources.
+      "controller": "A String", # Output only. Controller of the conversion source.
+      "expireTime": "A String", # Output only. The time when an archived conversion source becomes permanently deleted and is no longer available to undelete.
+      "googleAnalyticsLink": { # "Google Analytics Link" sources can be used to get conversion data from an existing Google Analytics property into the linked Merchant Center account. # Immutable. Conversion Source of type "Link to Google Analytics Property".
+        "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Output only. Attribution settings for the linked Google Analytics property.
+          "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+          "attributionModel": "A String", # Required. Attribution model.
+          "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+            { # Message representing the type of a conversion event.
+              "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+              "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+            },
+          ],
+        },
+        "property": "A String", # Output only. Name of the Google Analytics property the merchant is linked to.
+        "propertyId": "A String", # Required. Immutable. ID of the Google Analytics property the merchant is linked to.
+      },
+      "merchantCenterDestination": { # "Merchant Center Destination" sources can be used to send conversion events from an online store using a Google tag directly to a Merchant Center account where the source is created. # Conversion Source of type "Merchant Center Tag Destination".
+        "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Required. Attribution settings used for the Merchant Center Destination.
+          "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+          "attributionModel": "A String", # Required. Attribution model.
+          "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+            { # Message representing the type of a conversion event.
+              "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+              "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+            },
+          ],
+        },
+        "currencyCode": "A String", # Required. Three-letter currency code (ISO 4217). The currency code defines in which currency the conversions sent to this destination will be reported in Merchant Center.
+        "destination": "A String", # Output only. Merchant Center Destination ID.
+        "displayName": "A String", # Required. Merchant-specified display name for the destination. This is the name that identifies the conversion source within the Merchant Center UI. The maximum length is 64 characters.
+      },
+      "name": "A String", # Output only. Identifier. Generated by the Content API upon creation of a new `ConversionSource`. Format: `[a-z]{4}:.+` The four characters before the colon represent the type of conversion source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: * `galk`: For GoogleAnalyticsLink sources. * `mcdn`: For MerchantCenterDestination sources.
+      "state": "A String", # Output only. Current state of this conversion source. Can't be edited through the API.
+    },
+  ],
+  "nextPageToken": "A String", # Token to be used to fetch the next results page.
+}

+

+
+

+    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 information of an existing conversion source. Available only for Merchant Center Destination conversion sources.
+
+Args:
+  name: string, Output only. Identifier. Generated by the Content API upon creation of a new `ConversionSource`. Format: `[a-z]{4}:.+` The four characters before the colon represent the type of conversion source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: * `galk`: For GoogleAnalyticsLink sources. * `mcdn`: For MerchantCenterDestination sources. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a conversion source owned by a Merchant account. A merchant account can have up to 200 conversion sources.
+  "controller": "A String", # Output only. Controller of the conversion source.
+  "expireTime": "A String", # Output only. The time when an archived conversion source becomes permanently deleted and is no longer available to undelete.
+  "googleAnalyticsLink": { # "Google Analytics Link" sources can be used to get conversion data from an existing Google Analytics property into the linked Merchant Center account. # Immutable. Conversion Source of type "Link to Google Analytics Property".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Output only. Attribution settings for the linked Google Analytics property.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "property": "A String", # Output only. Name of the Google Analytics property the merchant is linked to.
+    "propertyId": "A String", # Required. Immutable. ID of the Google Analytics property the merchant is linked to.
+  },
+  "merchantCenterDestination": { # "Merchant Center Destination" sources can be used to send conversion events from an online store using a Google tag directly to a Merchant Center account where the source is created. # Conversion Source of type "Merchant Center Tag Destination".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Required. Attribution settings used for the Merchant Center Destination.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "currencyCode": "A String", # Required. Three-letter currency code (ISO 4217). The currency code defines in which currency the conversions sent to this destination will be reported in Merchant Center.
+    "destination": "A String", # Output only. Merchant Center Destination ID.
+    "displayName": "A String", # Required. Merchant-specified display name for the destination. This is the name that identifies the conversion source within the Merchant Center UI. The maximum length is 64 characters.
+  },
+  "name": "A String", # Output only. Identifier. Generated by the Content API upon creation of a new `ConversionSource`. Format: `[a-z]{4}:.+` The four characters before the colon represent the type of conversion source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: * `galk`: For GoogleAnalyticsLink sources. * `mcdn`: For MerchantCenterDestination sources.
+  "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.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a conversion source owned by a Merchant account. A merchant account can have up to 200 conversion sources.
+  "controller": "A String", # Output only. Controller of the conversion source.
+  "expireTime": "A String", # Output only. The time when an archived conversion source becomes permanently deleted and is no longer available to undelete.
+  "googleAnalyticsLink": { # "Google Analytics Link" sources can be used to get conversion data from an existing Google Analytics property into the linked Merchant Center account. # Immutable. Conversion Source of type "Link to Google Analytics Property".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Output only. Attribution settings for the linked Google Analytics property.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "property": "A String", # Output only. Name of the Google Analytics property the merchant is linked to.
+    "propertyId": "A String", # Required. Immutable. ID of the Google Analytics property the merchant is linked to.
+  },
+  "merchantCenterDestination": { # "Merchant Center Destination" sources can be used to send conversion events from an online store using a Google tag directly to a Merchant Center account where the source is created. # Conversion Source of type "Merchant Center Tag Destination".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Required. Attribution settings used for the Merchant Center Destination.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "currencyCode": "A String", # Required. Three-letter currency code (ISO 4217). The currency code defines in which currency the conversions sent to this destination will be reported in Merchant Center.
+    "destination": "A String", # Output only. Merchant Center Destination ID.
+    "displayName": "A String", # Required. Merchant-specified display name for the destination. This is the name that identifies the conversion source within the Merchant Center UI. The maximum length is 64 characters.
+  },
+  "name": "A String", # Output only. Identifier. Generated by the Content API upon creation of a new `ConversionSource`. Format: `[a-z]{4}:.+` The four characters before the colon represent the type of conversion source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: * `galk`: For GoogleAnalyticsLink sources. * `mcdn`: For MerchantCenterDestination sources.
+  "state": "A String", # Output only. Current state of this conversion source. Can't be edited through the API.
+}

+

+
+

+    undelete(name, body=None, x__xgafv=None)
+  
Re-enables an archived conversion source. Only Available for Merchant Center Destination conversion sources.
+
+Args:
+  name: string, Required. The name of the conversion source to be undeleted. Format: `accounts/{account}/conversionSources/{conversion_source}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the UndeleteConversionSource method.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a conversion source owned by a Merchant account. A merchant account can have up to 200 conversion sources.
+  "controller": "A String", # Output only. Controller of the conversion source.
+  "expireTime": "A String", # Output only. The time when an archived conversion source becomes permanently deleted and is no longer available to undelete.
+  "googleAnalyticsLink": { # "Google Analytics Link" sources can be used to get conversion data from an existing Google Analytics property into the linked Merchant Center account. # Immutable. Conversion Source of type "Link to Google Analytics Property".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Output only. Attribution settings for the linked Google Analytics property.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "property": "A String", # Output only. Name of the Google Analytics property the merchant is linked to.
+    "propertyId": "A String", # Required. Immutable. ID of the Google Analytics property the merchant is linked to.
+  },
+  "merchantCenterDestination": { # "Merchant Center Destination" sources can be used to send conversion events from an online store using a Google tag directly to a Merchant Center account where the source is created. # Conversion Source of type "Merchant Center Tag Destination".
+    "attributionSettings": { # Represents attribution settings for conversion sources receiving pre-attribution data. # Required. Attribution settings used for the Merchant Center Destination.
+      "attributionLookbackWindowDays": 42, # Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.
+      "attributionModel": "A String", # Required. Attribution model.
+      "conversionType": [ # Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.
+        { # Message representing the type of a conversion event.
+          "name": "A String", # Output only. Conversion event name, as it'll be reported by the client.
+          "report": True or False, # Output only. Option indicating if the type should be included in Merchant Center reporting.
+        },
+      ],
+    },
+    "currencyCode": "A String", # Required. Three-letter currency code (ISO 4217). The currency code defines in which currency the conversions sent to this destination will be reported in Merchant Center.
+    "destination": "A String", # Output only. Merchant Center Destination ID.
+    "displayName": "A String", # Required. Merchant-specified display name for the destination. This is the name that identifies the conversion source within the Merchant Center UI. The maximum length is 64 characters.
+  },
+  "name": "A String", # Output only. Identifier. Generated by the Content API upon creation of a new `ConversionSource`. Format: `[a-z]{4}:.+` The four characters before the colon represent the type of conversion source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: * `galk`: For GoogleAnalyticsLink sources. * `mcdn`: For MerchantCenterDestination sources.
+  "state": "A String", # Output only. Current state of this conversion source. Can't be edited through the API.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_conversions_v1.accounts.html b/docs/dyn/merchantapi_conversions_v1.accounts.html
new file mode 100644
index 00000000000..f6be942eec7
--- /dev/null
+++ b/docs/dyn/merchantapi_conversions_v1.accounts.html
@@ -0,0 +1,91 @@
+
+
+
+
Merchant API . accounts

+
Instance Methods

+

+  conversionSources()
+

+
Returns the conversionSources Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_conversions_v1.html b/docs/dyn/merchantapi_conversions_v1.html
new file mode 100644
index 00000000000..960272c9d29
--- /dev/null
+++ b/docs/dyn/merchantapi_conversions_v1.html
@@ -0,0 +1,111 @@
+
+
+
+
Merchant API

+
Instance Methods

+

+  accounts()
+

+
Returns the accounts Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  new_batch_http_request()

+
Create a BatchHttpRequest object based on the discovery document.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    new_batch_http_request()
+  
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_datasources_v1.accounts.dataSources.fileUploads.html b/docs/dyn/merchantapi_datasources_v1.accounts.dataSources.fileUploads.html
new file mode 100644
index 00000000000..96e3974270c
--- /dev/null
+++ b/docs/dyn/merchantapi_datasources_v1.accounts.dataSources.fileUploads.html
@@ -0,0 +1,124 @@
+
+
+
+
Merchant API . accounts . dataSources . fileUploads

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

+
Gets the latest data source file upload. Only the `latest` alias is accepted for a file upload.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    get(name, x__xgafv=None)
+  
Gets the latest data source file upload. Only the `latest` alias is accepted for a file upload.
+
+Args:
+  name: string, Required. The name of the data source file upload to retrieve. Format: `accounts/{account}/dataSources/{datasource}/fileUploads/latest` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The file upload of a specific data source, that is, the result of the retrieval of the data source at a certain timestamp computed asynchronously when the data source processing is finished. Only applicable to file data sources.
+  "dataSourceId": "A String", # Output only. The data source id.
+  "issues": [ # Output only. The list of issues occurring in the data source.
+    { # An error occurring in the data source, like "invalid price".
+      "code": "A String", # Output only. The code of the error, for example, "validation/invalid_value". Returns "?" if the code is unknown.
+      "count": "A String", # Output only. The number of occurrences of the error in the file upload.
+      "description": "A String", # Output only. The error description, for example, "Your data source contains items which have too many attributes, or are too big. These items will be dropped".
+      "documentationUri": "A String", # Output only. Link to the documentation explaining the issue in more details, if available.
+      "severity": "A String", # Output only. The severity of the issue.
+      "title": "A String", # Output only. The title of the issue, for example, "Item too big".
+    },
+  ],
+  "itemsCreated": "A String", # Output only. The number of items in the data source that were created.
+  "itemsTotal": "A String", # Output only. The number of items in the data source that were processed.
+  "itemsUpdated": "A String", # Output only. The number of items in the data source that were updated.
+  "name": "A String", # Identifier. The name of the data source file upload. Format: `{datasource.name=accounts/{account}/dataSources/{datasource}/fileUploads/{fileupload}}`
+  "processingState": "A String", # Output only. The processing state of the data source.
+  "uploadTime": "A String", # Output only. The date at which the file of the data source was uploaded.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_datasources_v1.accounts.dataSources.html b/docs/dyn/merchantapi_datasources_v1.accounts.dataSources.html
new file mode 100644
index 00000000000..ca614ba6684
--- /dev/null
+++ b/docs/dyn/merchantapi_datasources_v1.accounts.dataSources.html
@@ -0,0 +1,704 @@
+
+
+
+
Merchant API . accounts . dataSources

+
Instance Methods

+

+  fileUploads()
+

+
Returns the fileUploads Resource.

+
+

+  close()

+
Close httplib2 connections.

+

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

+
Creates the new data source configuration for the given account. This method always creates a new data source.

+

+  delete(name, x__xgafv=None)

+
Deletes a data source from your Merchant Center account.

+

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

+
Performs the data fetch immediately (even outside fetch schedule) on a data source from your Merchant Center Account. If you need to call this method more than once per day, you should use the Products service to update your product data instead. This method only works on data sources with a file input set.

+

+  get(name, x__xgafv=None)

+
Retrieves the data source configuration for the given account.

+

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

+
Lists the configurations for data sources for the given account.

+

+  list_next()

+
Retrieves the next page of results.

+

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

+
Updates the existing data source configuration. The fields that are set in the update mask but not provided in the resource will be deleted.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, x__xgafv=None)
+  
Creates the new data source configuration for the given account. This method always creates a new data source.
+
+Args:
+  parent: string, Required. The account where this data source will be created. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The [data source](/merchant/api/guides/data-sources/overview) for the Merchant Center account.
+  "dataSourceId": "A String", # Output only. The data source id.
+  "displayName": "A String", # Required. The displayed data source name in the Merchant Center UI.
+  "fileInput": { # The data specific for file data sources. This field is empty for other data source inputs. # Optional. The field is used only when data is managed through a file.
+    "fetchSettings": { # Fetch details to deliver the data source. # Optional. Fetch details to deliver the data source. It contains settings for `FETCH` and `GOOGLE_SHEETS` file input types. The required fields vary based on the frequency of fetching.
+      "dayOfMonth": 42, # Optional. The day of the month when the data source file should be fetched (1-31). This field can only be set for monthly frequency.
+      "dayOfWeek": "A String", # Optional. The day of the week when the data source file should be fetched. This field can only be set for weekly frequency.
+      "enabled": True or False, # Optional. Enables or pauses the fetch schedule.
+      "fetchUri": "A String", # Optional. The URL where the data source file can be fetched. Google Merchant Center supports automatic scheduled uploads using the HTTP, HTTPS or SFTP protocols, so the value will need to be a valid link using one of those three protocols. Immutable for Google Sheets files.
+      "frequency": "A String", # Required. The frequency describing fetch schedule.
+      "password": "A String", # Optional. An optional password for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+      "timeOfDay": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Optional. The hour of the day when the data source file should be fetched. Minutes and seconds are not supported and will be ignored.
+        "hours": 42, # Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
+        "nanos": 42, # Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
+        "seconds": 42, # Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.
+      },
+      "timeZone": "A String", # Optional. [Time zone](https://cldr.unicode.org) used for schedule. UTC by default. For example, "America/Los_Angeles".
+      "username": "A String", # Optional. An optional user name for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+    },
+    "fileInputType": "A String", # Output only. The type of file input.
+    "fileName": "A String", # Optional. The file name of the data source. Required for `UPLOAD` file input type.
+  },
+  "input": "A String", # Output only. Determines the type of input to the data source. Based on the input some settings might not work. Only generic data sources can be created through the API.
+  "localInventoryDataSource": { # The local inventory data source type is only available for file inputs and can't be used to create API local inventory data sources. # The [local inventory](https://support.google.com/merchants/answer/7023001) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the local inventory is provided.
+    "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the local inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+  },
+  "merchantReviewDataSource": { # The merchant review data source. # The [merchant review](https://support.google.com/merchants/answer/7045996) data source.
+  },
+  "name": "A String", # Required. Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`
+  "primaryProductDataSource": { # The primary data source for local and online products. # The [primary data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+    "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+    "countries": [ # Optional. The countries where the items may be displayed. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
+      "A String",
+    ],
+    "defaultRule": { # Default rule management of the data source. # Optional. Default rule management of the data source. If set, the linked data sources will be replaced.
+      "takeFromDataSources": [ # Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`.
+        { # Data source reference can be used to manage related data sources within the data source service.
+          "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+          "self": True or False, # Self should be used to reference the primary data source itself.
+          "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+        },
+      ],
+    },
+    "destinations": [ # Optional. A list of destinations describing where products of the data source can be shown. When retrieving the data source, the list contains all the destinations that can be used for the data source, including the ones that are disabled for the data source but enabled for the account. Only destinations that are enabled on the account, for example through program participation, can be enabled on the data source. If unset, during creation, the destinations will be inherited based on the account level program participation. If set, during creation or update, the data source will be set only for the specified destinations. Updating this field requires at least one destination.
+      { # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections.
+        "destination": "A String", # [Marketing methods](https://support.google.com/merchants/answer/15130232) (also known as destination) selections.
+        "state": "A String", # The state of the destination.
+      },
+    ],
+    "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+    "legacyLocal": True or False, # Optional. Immutable. Determines whether the products of this data source are **only** targeting local destinations. Legacy local products are prefixed with `local~` in the product resource ID. For example, `accounts/123/products/local~en~US~sku123`.
+  },
+  "productReviewDataSource": { # The product review data source. # The [product review](https://support.google.com/merchants/answer/7045996) data source.
+  },
+  "promotionDataSource": { # The promotion data source. # The [promotion](https://support.google.com/merchants/answer/2906014) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items in the data source.
+    "targetCountry": "A String", # Required. Immutable. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected [countries](https://support.google.com/merchants/answer/4588460).
+  },
+  "regionalInventoryDataSource": { # The [regional inventory](https://support.google.com/merchants/answer/7439058) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the regional inventory is provided.
+    "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the regional inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+  },
+  "supplementalProductDataSource": { # The supplemental data source for local and online products. After creation, you should make sure to link the supplemental product data source into one or more primary product data sources. # The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+    "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. The fields must be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "referencingPrimaryDataSources": [ # Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed.
+      { # Data source reference can be used to manage related data sources within the data source service.
+        "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+        "self": True or False, # Self should be used to reference the primary data source itself.
+        "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+      },
+    ],
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The [data source](/merchant/api/guides/data-sources/overview) for the Merchant Center account.
+  "dataSourceId": "A String", # Output only. The data source id.
+  "displayName": "A String", # Required. The displayed data source name in the Merchant Center UI.
+  "fileInput": { # The data specific for file data sources. This field is empty for other data source inputs. # Optional. The field is used only when data is managed through a file.
+    "fetchSettings": { # Fetch details to deliver the data source. # Optional. Fetch details to deliver the data source. It contains settings for `FETCH` and `GOOGLE_SHEETS` file input types. The required fields vary based on the frequency of fetching.
+      "dayOfMonth": 42, # Optional. The day of the month when the data source file should be fetched (1-31). This field can only be set for monthly frequency.
+      "dayOfWeek": "A String", # Optional. The day of the week when the data source file should be fetched. This field can only be set for weekly frequency.
+      "enabled": True or False, # Optional. Enables or pauses the fetch schedule.
+      "fetchUri": "A String", # Optional. The URL where the data source file can be fetched. Google Merchant Center supports automatic scheduled uploads using the HTTP, HTTPS or SFTP protocols, so the value will need to be a valid link using one of those three protocols. Immutable for Google Sheets files.
+      "frequency": "A String", # Required. The frequency describing fetch schedule.
+      "password": "A String", # Optional. An optional password for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+      "timeOfDay": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Optional. The hour of the day when the data source file should be fetched. Minutes and seconds are not supported and will be ignored.
+        "hours": 42, # Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
+        "nanos": 42, # Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
+        "seconds": 42, # Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.
+      },
+      "timeZone": "A String", # Optional. [Time zone](https://cldr.unicode.org) used for schedule. UTC by default. For example, "America/Los_Angeles".
+      "username": "A String", # Optional. An optional user name for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+    },
+    "fileInputType": "A String", # Output only. The type of file input.
+    "fileName": "A String", # Optional. The file name of the data source. Required for `UPLOAD` file input type.
+  },
+  "input": "A String", # Output only. Determines the type of input to the data source. Based on the input some settings might not work. Only generic data sources can be created through the API.
+  "localInventoryDataSource": { # The local inventory data source type is only available for file inputs and can't be used to create API local inventory data sources. # The [local inventory](https://support.google.com/merchants/answer/7023001) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the local inventory is provided.
+    "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the local inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+  },
+  "merchantReviewDataSource": { # The merchant review data source. # The [merchant review](https://support.google.com/merchants/answer/7045996) data source.
+  },
+  "name": "A String", # Required. Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`
+  "primaryProductDataSource": { # The primary data source for local and online products. # The [primary data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+    "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+    "countries": [ # Optional. The countries where the items may be displayed. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
+      "A String",
+    ],
+    "defaultRule": { # Default rule management of the data source. # Optional. Default rule management of the data source. If set, the linked data sources will be replaced.
+      "takeFromDataSources": [ # Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`.
+        { # Data source reference can be used to manage related data sources within the data source service.
+          "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+          "self": True or False, # Self should be used to reference the primary data source itself.
+          "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+        },
+      ],
+    },
+    "destinations": [ # Optional. A list of destinations describing where products of the data source can be shown. When retrieving the data source, the list contains all the destinations that can be used for the data source, including the ones that are disabled for the data source but enabled for the account. Only destinations that are enabled on the account, for example through program participation, can be enabled on the data source. If unset, during creation, the destinations will be inherited based on the account level program participation. If set, during creation or update, the data source will be set only for the specified destinations. Updating this field requires at least one destination.
+      { # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections.
+        "destination": "A String", # [Marketing methods](https://support.google.com/merchants/answer/15130232) (also known as destination) selections.
+        "state": "A String", # The state of the destination.
+      },
+    ],
+    "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+    "legacyLocal": True or False, # Optional. Immutable. Determines whether the products of this data source are **only** targeting local destinations. Legacy local products are prefixed with `local~` in the product resource ID. For example, `accounts/123/products/local~en~US~sku123`.
+  },
+  "productReviewDataSource": { # The product review data source. # The [product review](https://support.google.com/merchants/answer/7045996) data source.
+  },
+  "promotionDataSource": { # The promotion data source. # The [promotion](https://support.google.com/merchants/answer/2906014) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items in the data source.
+    "targetCountry": "A String", # Required. Immutable. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected [countries](https://support.google.com/merchants/answer/4588460).
+  },
+  "regionalInventoryDataSource": { # The [regional inventory](https://support.google.com/merchants/answer/7439058) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the regional inventory is provided.
+    "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the regional inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+  },
+  "supplementalProductDataSource": { # The supplemental data source for local and online products. After creation, you should make sure to link the supplemental product data source into one or more primary product data sources. # The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+    "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. The fields must be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "referencingPrimaryDataSources": [ # Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed.
+      { # Data source reference can be used to manage related data sources within the data source service.
+        "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+        "self": True or False, # Self should be used to reference the primary data source itself.
+        "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+      },
+    ],
+  },
+}

+

+
+

+    delete(name, x__xgafv=None)
+  
Deletes a data source from your Merchant Center account.
+
+Args:
+  name: string, Required. The name of the data source to delete. Format: `accounts/{account}/dataSources/{datasource}` (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); }
+}

+

+
+

+    fetch(name, body=None, x__xgafv=None)
+  
Performs the data fetch immediately (even outside fetch schedule) on a data source from your Merchant Center Account. If you need to call this method more than once per day, you should use the Products service to update your product data instead. This method only works on data sources with a file input set.
+
+Args:
+  name: string, Required. The name of the data source resource to fetch. Format: `accounts/{account}/dataSources/{datasource}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the FetchDataSource method.
+}
+
+  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)
+  
Retrieves the data source configuration for the given account.
+
+Args:
+  name: string, Required. The name of the data source to retrieve. Format: `accounts/{account}/dataSources/{datasource}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The [data source](/merchant/api/guides/data-sources/overview) for the Merchant Center account.
+  "dataSourceId": "A String", # Output only. The data source id.
+  "displayName": "A String", # Required. The displayed data source name in the Merchant Center UI.
+  "fileInput": { # The data specific for file data sources. This field is empty for other data source inputs. # Optional. The field is used only when data is managed through a file.
+    "fetchSettings": { # Fetch details to deliver the data source. # Optional. Fetch details to deliver the data source. It contains settings for `FETCH` and `GOOGLE_SHEETS` file input types. The required fields vary based on the frequency of fetching.
+      "dayOfMonth": 42, # Optional. The day of the month when the data source file should be fetched (1-31). This field can only be set for monthly frequency.
+      "dayOfWeek": "A String", # Optional. The day of the week when the data source file should be fetched. This field can only be set for weekly frequency.
+      "enabled": True or False, # Optional. Enables or pauses the fetch schedule.
+      "fetchUri": "A String", # Optional. The URL where the data source file can be fetched. Google Merchant Center supports automatic scheduled uploads using the HTTP, HTTPS or SFTP protocols, so the value will need to be a valid link using one of those three protocols. Immutable for Google Sheets files.
+      "frequency": "A String", # Required. The frequency describing fetch schedule.
+      "password": "A String", # Optional. An optional password for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+      "timeOfDay": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Optional. The hour of the day when the data source file should be fetched. Minutes and seconds are not supported and will be ignored.
+        "hours": 42, # Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
+        "nanos": 42, # Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
+        "seconds": 42, # Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.
+      },
+      "timeZone": "A String", # Optional. [Time zone](https://cldr.unicode.org) used for schedule. UTC by default. For example, "America/Los_Angeles".
+      "username": "A String", # Optional. An optional user name for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+    },
+    "fileInputType": "A String", # Output only. The type of file input.
+    "fileName": "A String", # Optional. The file name of the data source. Required for `UPLOAD` file input type.
+  },
+  "input": "A String", # Output only. Determines the type of input to the data source. Based on the input some settings might not work. Only generic data sources can be created through the API.
+  "localInventoryDataSource": { # The local inventory data source type is only available for file inputs and can't be used to create API local inventory data sources. # The [local inventory](https://support.google.com/merchants/answer/7023001) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the local inventory is provided.
+    "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the local inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+  },
+  "merchantReviewDataSource": { # The merchant review data source. # The [merchant review](https://support.google.com/merchants/answer/7045996) data source.
+  },
+  "name": "A String", # Required. Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`
+  "primaryProductDataSource": { # The primary data source for local and online products. # The [primary data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+    "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+    "countries": [ # Optional. The countries where the items may be displayed. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
+      "A String",
+    ],
+    "defaultRule": { # Default rule management of the data source. # Optional. Default rule management of the data source. If set, the linked data sources will be replaced.
+      "takeFromDataSources": [ # Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`.
+        { # Data source reference can be used to manage related data sources within the data source service.
+          "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+          "self": True or False, # Self should be used to reference the primary data source itself.
+          "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+        },
+      ],
+    },
+    "destinations": [ # Optional. A list of destinations describing where products of the data source can be shown. When retrieving the data source, the list contains all the destinations that can be used for the data source, including the ones that are disabled for the data source but enabled for the account. Only destinations that are enabled on the account, for example through program participation, can be enabled on the data source. If unset, during creation, the destinations will be inherited based on the account level program participation. If set, during creation or update, the data source will be set only for the specified destinations. Updating this field requires at least one destination.
+      { # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections.
+        "destination": "A String", # [Marketing methods](https://support.google.com/merchants/answer/15130232) (also known as destination) selections.
+        "state": "A String", # The state of the destination.
+      },
+    ],
+    "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+    "legacyLocal": True or False, # Optional. Immutable. Determines whether the products of this data source are **only** targeting local destinations. Legacy local products are prefixed with `local~` in the product resource ID. For example, `accounts/123/products/local~en~US~sku123`.
+  },
+  "productReviewDataSource": { # The product review data source. # The [product review](https://support.google.com/merchants/answer/7045996) data source.
+  },
+  "promotionDataSource": { # The promotion data source. # The [promotion](https://support.google.com/merchants/answer/2906014) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items in the data source.
+    "targetCountry": "A String", # Required. Immutable. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected [countries](https://support.google.com/merchants/answer/4588460).
+  },
+  "regionalInventoryDataSource": { # The [regional inventory](https://support.google.com/merchants/answer/7439058) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the regional inventory is provided.
+    "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the regional inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+  },
+  "supplementalProductDataSource": { # The supplemental data source for local and online products. After creation, you should make sure to link the supplemental product data source into one or more primary product data sources. # The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+    "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. The fields must be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "referencingPrimaryDataSources": [ # Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed.
+      { # Data source reference can be used to manage related data sources within the data source service.
+        "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+        "self": True or False, # Self should be used to reference the primary data source itself.
+        "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+      },
+    ],
+  },
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists the configurations for data sources for the given account.
+
+Args:
+  parent: string, Required. The account to list data sources for. Format: `accounts/{account}` (required)
+  pageSize: integer, Optional. The maximum number of data sources to return. The service may return fewer than this value. The maximum value is 1000; values above 1000 will be coerced to 1000. If unspecified, the maximum number of data sources will be returned.
+  pageToken: string, Optional. A page token, received from a previous `ListDataSources` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListDataSources` 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 the ListDataSources method.
+  "dataSources": [ # The data sources from the specified account.
+    { # The [data source](/merchant/api/guides/data-sources/overview) for the Merchant Center account.
+      "dataSourceId": "A String", # Output only. The data source id.
+      "displayName": "A String", # Required. The displayed data source name in the Merchant Center UI.
+      "fileInput": { # The data specific for file data sources. This field is empty for other data source inputs. # Optional. The field is used only when data is managed through a file.
+        "fetchSettings": { # Fetch details to deliver the data source. # Optional. Fetch details to deliver the data source. It contains settings for `FETCH` and `GOOGLE_SHEETS` file input types. The required fields vary based on the frequency of fetching.
+          "dayOfMonth": 42, # Optional. The day of the month when the data source file should be fetched (1-31). This field can only be set for monthly frequency.
+          "dayOfWeek": "A String", # Optional. The day of the week when the data source file should be fetched. This field can only be set for weekly frequency.
+          "enabled": True or False, # Optional. Enables or pauses the fetch schedule.
+          "fetchUri": "A String", # Optional. The URL where the data source file can be fetched. Google Merchant Center supports automatic scheduled uploads using the HTTP, HTTPS or SFTP protocols, so the value will need to be a valid link using one of those three protocols. Immutable for Google Sheets files.
+          "frequency": "A String", # Required. The frequency describing fetch schedule.
+          "password": "A String", # Optional. An optional password for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+          "timeOfDay": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Optional. The hour of the day when the data source file should be fetched. Minutes and seconds are not supported and will be ignored.
+            "hours": 42, # Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+            "minutes": 42, # Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
+            "nanos": 42, # Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
+            "seconds": 42, # Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.
+          },
+          "timeZone": "A String", # Optional. [Time zone](https://cldr.unicode.org) used for schedule. UTC by default. For example, "America/Los_Angeles".
+          "username": "A String", # Optional. An optional user name for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+        },
+        "fileInputType": "A String", # Output only. The type of file input.
+        "fileName": "A String", # Optional. The file name of the data source. Required for `UPLOAD` file input type.
+      },
+      "input": "A String", # Output only. Determines the type of input to the data source. Based on the input some settings might not work. Only generic data sources can be created through the API.
+      "localInventoryDataSource": { # The local inventory data source type is only available for file inputs and can't be used to create API local inventory data sources. # The [local inventory](https://support.google.com/merchants/answer/7023001) data source.
+        "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the local inventory is provided.
+        "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the local inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+      },
+      "merchantReviewDataSource": { # The merchant review data source. # The [merchant review](https://support.google.com/merchants/answer/7045996) data source.
+      },
+      "name": "A String", # Required. Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`
+      "primaryProductDataSource": { # The primary data source for local and online products. # The [primary data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+        "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+        "countries": [ # Optional. The countries where the items may be displayed. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
+          "A String",
+        ],
+        "defaultRule": { # Default rule management of the data source. # Optional. Default rule management of the data source. If set, the linked data sources will be replaced.
+          "takeFromDataSources": [ # Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`.
+            { # Data source reference can be used to manage related data sources within the data source service.
+              "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+              "self": True or False, # Self should be used to reference the primary data source itself.
+              "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+            },
+          ],
+        },
+        "destinations": [ # Optional. A list of destinations describing where products of the data source can be shown. When retrieving the data source, the list contains all the destinations that can be used for the data source, including the ones that are disabled for the data source but enabled for the account. Only destinations that are enabled on the account, for example through program participation, can be enabled on the data source. If unset, during creation, the destinations will be inherited based on the account level program participation. If set, during creation or update, the data source will be set only for the specified destinations. Updating this field requires at least one destination.
+          { # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections.
+            "destination": "A String", # [Marketing methods](https://support.google.com/merchants/answer/15130232) (also known as destination) selections.
+            "state": "A String", # The state of the destination.
+          },
+        ],
+        "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+        "legacyLocal": True or False, # Optional. Immutable. Determines whether the products of this data source are **only** targeting local destinations. Legacy local products are prefixed with `local~` in the product resource ID. For example, `accounts/123/products/local~en~US~sku123`.
+      },
+      "productReviewDataSource": { # The product review data source. # The [product review](https://support.google.com/merchants/answer/7045996) data source.
+      },
+      "promotionDataSource": { # The promotion data source. # The [promotion](https://support.google.com/merchants/answer/2906014) data source.
+        "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items in the data source.
+        "targetCountry": "A String", # Required. Immutable. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected [countries](https://support.google.com/merchants/answer/4588460).
+      },
+      "regionalInventoryDataSource": { # The [regional inventory](https://support.google.com/merchants/answer/7439058) data source.
+        "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the regional inventory is provided.
+        "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the regional inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+      },
+      "supplementalProductDataSource": { # The supplemental data source for local and online products. After creation, you should make sure to link the supplemental product data source into one or more primary product data sources. # The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+        "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+        "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. The fields must be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+        "referencingPrimaryDataSources": [ # Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed.
+          { # Data source reference can be used to manage related data sources within the data source service.
+            "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+            "self": True or False, # Self should be used to reference the primary data source itself.
+            "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+          },
+        ],
+      },
+    },
+  ],
+  "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.
+}

+

+
+

+    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 existing data source configuration. The fields that are set in the update mask but not provided in the resource will be deleted.
+
+Args:
+  name: string, Required. Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The [data source](/merchant/api/guides/data-sources/overview) for the Merchant Center account.
+  "dataSourceId": "A String", # Output only. The data source id.
+  "displayName": "A String", # Required. The displayed data source name in the Merchant Center UI.
+  "fileInput": { # The data specific for file data sources. This field is empty for other data source inputs. # Optional. The field is used only when data is managed through a file.
+    "fetchSettings": { # Fetch details to deliver the data source. # Optional. Fetch details to deliver the data source. It contains settings for `FETCH` and `GOOGLE_SHEETS` file input types. The required fields vary based on the frequency of fetching.
+      "dayOfMonth": 42, # Optional. The day of the month when the data source file should be fetched (1-31). This field can only be set for monthly frequency.
+      "dayOfWeek": "A String", # Optional. The day of the week when the data source file should be fetched. This field can only be set for weekly frequency.
+      "enabled": True or False, # Optional. Enables or pauses the fetch schedule.
+      "fetchUri": "A String", # Optional. The URL where the data source file can be fetched. Google Merchant Center supports automatic scheduled uploads using the HTTP, HTTPS or SFTP protocols, so the value will need to be a valid link using one of those three protocols. Immutable for Google Sheets files.
+      "frequency": "A String", # Required. The frequency describing fetch schedule.
+      "password": "A String", # Optional. An optional password for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+      "timeOfDay": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Optional. The hour of the day when the data source file should be fetched. Minutes and seconds are not supported and will be ignored.
+        "hours": 42, # Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
+        "nanos": 42, # Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
+        "seconds": 42, # Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.
+      },
+      "timeZone": "A String", # Optional. [Time zone](https://cldr.unicode.org) used for schedule. UTC by default. For example, "America/Los_Angeles".
+      "username": "A String", # Optional. An optional user name for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+    },
+    "fileInputType": "A String", # Output only. The type of file input.
+    "fileName": "A String", # Optional. The file name of the data source. Required for `UPLOAD` file input type.
+  },
+  "input": "A String", # Output only. Determines the type of input to the data source. Based on the input some settings might not work. Only generic data sources can be created through the API.
+  "localInventoryDataSource": { # The local inventory data source type is only available for file inputs and can't be used to create API local inventory data sources. # The [local inventory](https://support.google.com/merchants/answer/7023001) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the local inventory is provided.
+    "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the local inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+  },
+  "merchantReviewDataSource": { # The merchant review data source. # The [merchant review](https://support.google.com/merchants/answer/7045996) data source.
+  },
+  "name": "A String", # Required. Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`
+  "primaryProductDataSource": { # The primary data source for local and online products. # The [primary data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+    "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+    "countries": [ # Optional. The countries where the items may be displayed. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
+      "A String",
+    ],
+    "defaultRule": { # Default rule management of the data source. # Optional. Default rule management of the data source. If set, the linked data sources will be replaced.
+      "takeFromDataSources": [ # Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`.
+        { # Data source reference can be used to manage related data sources within the data source service.
+          "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+          "self": True or False, # Self should be used to reference the primary data source itself.
+          "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+        },
+      ],
+    },
+    "destinations": [ # Optional. A list of destinations describing where products of the data source can be shown. When retrieving the data source, the list contains all the destinations that can be used for the data source, including the ones that are disabled for the data source but enabled for the account. Only destinations that are enabled on the account, for example through program participation, can be enabled on the data source. If unset, during creation, the destinations will be inherited based on the account level program participation. If set, during creation or update, the data source will be set only for the specified destinations. Updating this field requires at least one destination.
+      { # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections.
+        "destination": "A String", # [Marketing methods](https://support.google.com/merchants/answer/15130232) (also known as destination) selections.
+        "state": "A String", # The state of the destination.
+      },
+    ],
+    "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+    "legacyLocal": True or False, # Optional. Immutable. Determines whether the products of this data source are **only** targeting local destinations. Legacy local products are prefixed with `local~` in the product resource ID. For example, `accounts/123/products/local~en~US~sku123`.
+  },
+  "productReviewDataSource": { # The product review data source. # The [product review](https://support.google.com/merchants/answer/7045996) data source.
+  },
+  "promotionDataSource": { # The promotion data source. # The [promotion](https://support.google.com/merchants/answer/2906014) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items in the data source.
+    "targetCountry": "A String", # Required. Immutable. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected [countries](https://support.google.com/merchants/answer/4588460).
+  },
+  "regionalInventoryDataSource": { # The [regional inventory](https://support.google.com/merchants/answer/7439058) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the regional inventory is provided.
+    "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the regional inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+  },
+  "supplementalProductDataSource": { # The supplemental data source for local and online products. After creation, you should make sure to link the supplemental product data source into one or more primary product data sources. # The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+    "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. The fields must be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "referencingPrimaryDataSources": [ # Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed.
+      { # Data source reference can be used to manage related data sources within the data source service.
+        "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+        "self": True or False, # Self should be used to reference the primary data source itself.
+        "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+      },
+    ],
+  },
+}
+
+  updateMask: string, Required. The list of data source fields to be updated. Fields specified in the update mask without a value specified in the body will be deleted from the data source. Providing special "*" value for full data source replacement is not supported. For example, If you insert `updateMask=displayName` in the request, it will only update the `displayName` leaving all other fields untouched.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The [data source](/merchant/api/guides/data-sources/overview) for the Merchant Center account.
+  "dataSourceId": "A String", # Output only. The data source id.
+  "displayName": "A String", # Required. The displayed data source name in the Merchant Center UI.
+  "fileInput": { # The data specific for file data sources. This field is empty for other data source inputs. # Optional. The field is used only when data is managed through a file.
+    "fetchSettings": { # Fetch details to deliver the data source. # Optional. Fetch details to deliver the data source. It contains settings for `FETCH` and `GOOGLE_SHEETS` file input types. The required fields vary based on the frequency of fetching.
+      "dayOfMonth": 42, # Optional. The day of the month when the data source file should be fetched (1-31). This field can only be set for monthly frequency.
+      "dayOfWeek": "A String", # Optional. The day of the week when the data source file should be fetched. This field can only be set for weekly frequency.
+      "enabled": True or False, # Optional. Enables or pauses the fetch schedule.
+      "fetchUri": "A String", # Optional. The URL where the data source file can be fetched. Google Merchant Center supports automatic scheduled uploads using the HTTP, HTTPS or SFTP protocols, so the value will need to be a valid link using one of those three protocols. Immutable for Google Sheets files.
+      "frequency": "A String", # Required. The frequency describing fetch schedule.
+      "password": "A String", # Optional. An optional password for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+      "timeOfDay": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Optional. The hour of the day when the data source file should be fetched. Minutes and seconds are not supported and will be ignored.
+        "hours": 42, # Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
+        "nanos": 42, # Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
+        "seconds": 42, # Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.
+      },
+      "timeZone": "A String", # Optional. [Time zone](https://cldr.unicode.org) used for schedule. UTC by default. For example, "America/Los_Angeles".
+      "username": "A String", # Optional. An optional user name for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).
+    },
+    "fileInputType": "A String", # Output only. The type of file input.
+    "fileName": "A String", # Optional. The file name of the data source. Required for `UPLOAD` file input type.
+  },
+  "input": "A String", # Output only. Determines the type of input to the data source. Based on the input some settings might not work. Only generic data sources can be created through the API.
+  "localInventoryDataSource": { # The local inventory data source type is only available for file inputs and can't be used to create API local inventory data sources. # The [local inventory](https://support.google.com/merchants/answer/7023001) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the local inventory is provided.
+    "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the local inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+  },
+  "merchantReviewDataSource": { # The merchant review data source. # The [merchant review](https://support.google.com/merchants/answer/7045996) data source.
+  },
+  "name": "A String", # Required. Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`
+  "primaryProductDataSource": { # The primary data source for local and online products. # The [primary data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+    "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+    "countries": [ # Optional. The countries where the items may be displayed. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
+      "A String",
+    ],
+    "defaultRule": { # Default rule management of the data source. # Optional. Default rule management of the data source. If set, the linked data sources will be replaced.
+      "takeFromDataSources": [ # Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`.
+        { # Data source reference can be used to manage related data sources within the data source service.
+          "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+          "self": True or False, # Self should be used to reference the primary data source itself.
+          "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+        },
+      ],
+    },
+    "destinations": [ # Optional. A list of destinations describing where products of the data source can be shown. When retrieving the data source, the list contains all the destinations that can be used for the data source, including the ones that are disabled for the data source but enabled for the account. Only destinations that are enabled on the account, for example through program participation, can be enabled on the data source. If unset, during creation, the destinations will be inherited based on the account level program participation. If set, during creation or update, the data source will be set only for the specified destinations. Updating this field requires at least one destination.
+      { # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections.
+        "destination": "A String", # [Marketing methods](https://support.google.com/merchants/answer/15130232) (also known as destination) selections.
+        "state": "A String", # The state of the destination.
+      },
+    ],
+    "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
+    "legacyLocal": True or False, # Optional. Immutable. Determines whether the products of this data source are **only** targeting local destinations. Legacy local products are prefixed with `local~` in the product resource ID. For example, `accounts/123/products/local~en~US~sku123`.
+  },
+  "productReviewDataSource": { # The product review data source. # The [product review](https://support.google.com/merchants/answer/7045996) data source.
+  },
+  "promotionDataSource": { # The promotion data source. # The [promotion](https://support.google.com/merchants/answer/2906014) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items in the data source.
+    "targetCountry": "A String", # Required. Immutable. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected [countries](https://support.google.com/merchants/answer/4588460).
+  },
+  "regionalInventoryDataSource": { # The [regional inventory](https://support.google.com/merchants/answer/7439058) data source.
+    "contentLanguage": "A String", # Required. Immutable. The two-letter ISO 639-1 language of the items to which the regional inventory is provided.
+    "feedLabel": "A String", # Required. Immutable. The feed label of the offers to which the regional inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+  },
+  "supplementalProductDataSource": { # The supplemental data source for local and online products. After creation, you should make sure to link the supplemental product data source into one or more primary product data sources. # The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products.
+    "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. The fields must be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "referencingPrimaryDataSources": [ # Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed.
+      { # Data source reference can be used to manage related data sources within the data source service.
+        "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+        "self": True or False, # Self should be used to reference the primary data source itself.
+        "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+      },
+    ],
+  },
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_datasources_v1.accounts.html b/docs/dyn/merchantapi_datasources_v1.accounts.html
new file mode 100644
index 00000000000..b813ae0ed95
--- /dev/null
+++ b/docs/dyn/merchantapi_datasources_v1.accounts.html
@@ -0,0 +1,91 @@
+
+
+
+
Merchant API . accounts

+
Instance Methods

+

+  dataSources()
+

+
Returns the dataSources Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_datasources_v1.html b/docs/dyn/merchantapi_datasources_v1.html
new file mode 100644
index 00000000000..9c513e646cb
--- /dev/null
+++ b/docs/dyn/merchantapi_datasources_v1.html
@@ -0,0 +1,111 @@
+
+
+
+
Merchant API

+
Instance Methods

+

+  accounts()
+

+
Returns the accounts Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  new_batch_http_request()

+
Create a BatchHttpRequest object based on the discovery document.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    new_batch_http_request()
+  
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_inventories_v1.accounts.html b/docs/dyn/merchantapi_inventories_v1.accounts.html
new file mode 100644
index 00000000000..46ccede6d96
--- /dev/null
+++ b/docs/dyn/merchantapi_inventories_v1.accounts.html
@@ -0,0 +1,91 @@
+
+
+
+
Merchant API . accounts

+
Instance Methods

+

+  products()
+

+
Returns the products Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_inventories_v1.accounts.products.html b/docs/dyn/merchantapi_inventories_v1.accounts.products.html
new file mode 100644
index 00000000000..7bb4a0442b2
--- /dev/null
+++ b/docs/dyn/merchantapi_inventories_v1.accounts.products.html
@@ -0,0 +1,96 @@
+
+
+
+
Merchant API . accounts . products

+
Instance Methods

+

+  localInventories()
+

+
Returns the localInventories Resource.

+
+

+  regionalInventories()
+

+
Returns the regionalInventories Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_inventories_v1.accounts.products.localInventories.html b/docs/dyn/merchantapi_inventories_v1.accounts.products.localInventories.html
new file mode 100644
index 00000000000..3f3450f44db
--- /dev/null
+++ b/docs/dyn/merchantapi_inventories_v1.accounts.products.localInventories.html
@@ -0,0 +1,245 @@
+
+
+
+
Merchant API . accounts . products . localInventories

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  delete(name, x__xgafv=None)

+
Deletes the specified `LocalInventory` from the given product in your merchant account. It might take a up to an hour for the `LocalInventory` to be deleted from the specific product. Once you have received a successful delete response, wait for that period before attempting a delete again.

+

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

+
Inserts a `LocalInventory` resource to a product in your merchant account. Replaces the full `LocalInventory` resource if an entry with the same `storeCode` already exists for the product. It might take up to 30 minutes for the new or updated `LocalInventory` resource to appear in products.

+

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

+
Lists the `LocalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `LocalInventory` resources are listed per product for a given account.

+

+  list_next()

+
Retrieves the next page of results.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    delete(name, x__xgafv=None)
+  
Deletes the specified `LocalInventory` from the given product in your merchant account. It might take a up to an hour for the `LocalInventory` to be deleted from the specific product. Once you have received a successful delete response, wait for that period before attempting a delete again.
+
+Args:
+  name: string, Required. The name of the local inventory for the given product to delete. Format: `accounts/{account}/products/{product}/localInventories/{store_code}` (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); }
+}

+

+
+

+    insert(parent, body=None, x__xgafv=None)
+  
Inserts a `LocalInventory` resource to a product in your merchant account. Replaces the full `LocalInventory` resource if an entry with the same `storeCode` already exists for the product. It might take up to 30 minutes for the new or updated `LocalInventory` resource to appear in products.
+
+Args:
+  parent: string, Required. The account and product where this inventory will be inserted. Format: `accounts/{account}/products/{product}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Local inventory information for the product. Represents in-store information for a specific product at the store specified by `storeCode`. For a list of all accepted attribute values, see the [local product inventory data specification](https://support.google.com/merchants/answer/3061342).
+  "account": "A String", # Output only. The account that owns the product. This field will be ignored if set by the client.
+  "localInventoryAttributes": { # Local inventory attributes. # Optional. A list of local inventory attributes.
+    "availability": "A String", # [Availability](https://support.google.com/merchants/answer/3061342) of the product at this store.
+    "instoreProductLocation": "A String", # Optional. Location of the product inside the store. Maximum length is 20 bytes.
+    "pickupMethod": "A String", # Optional. Supported [pickup method](https://support.google.com/merchants/answer/3061342) for this product. Unless the value is `"not supported"`, this field must be submitted together with `pickupSla`.
+    "pickupSla": "A String", # Optional. Relative time period from the order date for an order for this product, from this store, to be ready for pickup. Must be submitted with `pickupMethod`. See more details [here](https://support.google.com/merchants/answer/3061342).
+    "price": { # The price represented as a number and currency. # Optional. Price of the product at this store.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "quantity": "A String", # Optional. Quantity of the product available at this store. Must be greater than or equal to zero.
+    "salePrice": { # The price represented as a number and currency. # Optional. Sale price of the product at this store. Mandatory if `salePriceEffectiveDate` is defined.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Optional. The `TimePeriod` of the sale at this store.
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+  },
+  "name": "A String", # Output only. The name of the `LocalInventory` resource. Format: `accounts/{account}/products/{product}/localInventories/{store_code}`
+  "storeCode": "A String", # Required. Immutable. Store code (the store ID from your Business Profile) of the physical store the product is sold in. See the [Local product inventory data specification](https://support.google.com/merchants/answer/3061342) for more information.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Local inventory information for the product. Represents in-store information for a specific product at the store specified by `storeCode`. For a list of all accepted attribute values, see the [local product inventory data specification](https://support.google.com/merchants/answer/3061342).
+  "account": "A String", # Output only. The account that owns the product. This field will be ignored if set by the client.
+  "localInventoryAttributes": { # Local inventory attributes. # Optional. A list of local inventory attributes.
+    "availability": "A String", # [Availability](https://support.google.com/merchants/answer/3061342) of the product at this store.
+    "instoreProductLocation": "A String", # Optional. Location of the product inside the store. Maximum length is 20 bytes.
+    "pickupMethod": "A String", # Optional. Supported [pickup method](https://support.google.com/merchants/answer/3061342) for this product. Unless the value is `"not supported"`, this field must be submitted together with `pickupSla`.
+    "pickupSla": "A String", # Optional. Relative time period from the order date for an order for this product, from this store, to be ready for pickup. Must be submitted with `pickupMethod`. See more details [here](https://support.google.com/merchants/answer/3061342).
+    "price": { # The price represented as a number and currency. # Optional. Price of the product at this store.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "quantity": "A String", # Optional. Quantity of the product available at this store. Must be greater than or equal to zero.
+    "salePrice": { # The price represented as a number and currency. # Optional. Sale price of the product at this store. Mandatory if `salePriceEffectiveDate` is defined.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Optional. The `TimePeriod` of the sale at this store.
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+  },
+  "name": "A String", # Output only. The name of the `LocalInventory` resource. Format: `accounts/{account}/products/{product}/localInventories/{store_code}`
+  "storeCode": "A String", # Required. Immutable. Store code (the store ID from your Business Profile) of the physical store the product is sold in. See the [Local product inventory data specification](https://support.google.com/merchants/answer/3061342) for more information.
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists the `LocalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `LocalInventory` resources are listed per product for a given account.
+
+Args:
+  parent: string, Required. The `name` of the parent product to list local inventories for. Format: `accounts/{account}/products/{product}` (required)
+  pageSize: integer, The maximum number of `LocalInventory` resources for the given product to return. The service returns fewer than this value if the number of inventories for the given product is less that than the `pageSize`. The default value is 25000. The maximum value is 25000; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum
+  pageToken: string, A page token, received from a previous `ListLocalInventories` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `ListLocalInventories` must match the call that provided the page token. The token returned as nextPageToken in the response to the previous request.
+  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 `ListLocalInventories` method.
+  "localInventories": [ # The `LocalInventory` resources for the given product from the specified account.
+    { # Local inventory information for the product. Represents in-store information for a specific product at the store specified by `storeCode`. For a list of all accepted attribute values, see the [local product inventory data specification](https://support.google.com/merchants/answer/3061342).
+      "account": "A String", # Output only. The account that owns the product. This field will be ignored if set by the client.
+      "localInventoryAttributes": { # Local inventory attributes. # Optional. A list of local inventory attributes.
+        "availability": "A String", # [Availability](https://support.google.com/merchants/answer/3061342) of the product at this store.
+        "instoreProductLocation": "A String", # Optional. Location of the product inside the store. Maximum length is 20 bytes.
+        "pickupMethod": "A String", # Optional. Supported [pickup method](https://support.google.com/merchants/answer/3061342) for this product. Unless the value is `"not supported"`, this field must be submitted together with `pickupSla`.
+        "pickupSla": "A String", # Optional. Relative time period from the order date for an order for this product, from this store, to be ready for pickup. Must be submitted with `pickupMethod`. See more details [here](https://support.google.com/merchants/answer/3061342).
+        "price": { # The price represented as a number and currency. # Optional. Price of the product at this store.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "quantity": "A String", # Optional. Quantity of the product available at this store. Must be greater than or equal to zero.
+        "salePrice": { # The price represented as a number and currency. # Optional. Sale price of the product at this store. Mandatory if `salePriceEffectiveDate` is defined.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Optional. The `TimePeriod` of the sale at this store.
+          "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+          "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+        },
+      },
+      "name": "A String", # Output only. The name of the `LocalInventory` resource. Format: `accounts/{account}/products/{product}/localInventories/{store_code}`
+      "storeCode": "A String", # Required. Immutable. Store code (the store ID from your Business Profile) of the physical store the product is sold in. See the [Local product inventory data specification](https://support.google.com/merchants/answer/3061342) for more information.
+    },
+  ],
+  "nextPageToken": "A String", # A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+}

+

+
+

+    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/merchantapi_inventories_v1.accounts.products.regionalInventories.html b/docs/dyn/merchantapi_inventories_v1.accounts.products.regionalInventories.html
new file mode 100644
index 00000000000..acf86e6c363
--- /dev/null
+++ b/docs/dyn/merchantapi_inventories_v1.accounts.products.regionalInventories.html
@@ -0,0 +1,233 @@
+
+
+
+
Merchant API . accounts . products . regionalInventories

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  delete(name, x__xgafv=None)

+
Deletes the specified `RegionalInventory` resource from the given product in your merchant account. It might take up to an hour for the `RegionalInventory` to be deleted from the specific product. Once you have received a successful delete response, wait for that period before attempting a delete again.

+

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

+
Inserts a `RegionalInventory` to a given product in your merchant account. Replaces the full `RegionalInventory` resource if an entry with the same `region` already exists for the product. It might take up to 30 minutes for the new or updated `RegionalInventory` resource to appear in products.

+

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

+
Lists the `RegionalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `RegionalInventory` resources are listed per product for a given account.

+

+  list_next()

+
Retrieves the next page of results.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    delete(name, x__xgafv=None)
+  
Deletes the specified `RegionalInventory` resource from the given product in your merchant account. It might take up to an hour for the `RegionalInventory` to be deleted from the specific product. Once you have received a successful delete response, wait for that period before attempting a delete again.
+
+Args:
+  name: string, Required. The name of the `RegionalInventory` resource to delete. Format: `accounts/{account}/products/{product}/regionalInventories/{region}` (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); }
+}

+

+
+

+    insert(parent, body=None, x__xgafv=None)
+  
Inserts a `RegionalInventory` to a given product in your merchant account. Replaces the full `RegionalInventory` resource if an entry with the same `region` already exists for the product. It might take up to 30 minutes for the new or updated `RegionalInventory` resource to appear in products.
+
+Args:
+  parent: string, Required. The account and product where this inventory will be inserted. Format: `accounts/{account}/products/{product}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Regional inventory information for the product. Represents specific information like price and availability for a given product in a specific `region`. For a list of all accepted attribute values, see the [regional product inventory data specification](https://support.google.com/merchants/answer/9698880).
+  "account": "A String", # Output only. The account that owns the product. This field will be ignored if set by the client.
+  "name": "A String", # Output only. The name of the `RegionalInventory` resource. Format: `{regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}`
+  "region": "A String", # Required. Immutable. ID of the region for this `RegionalInventory` resource. See the [Regional availability and pricing](https://support.google.com/merchants/answer/9698880) for more details.
+  "regionalInventoryAttributes": { # Regional inventory attributes. # Optional. A list of regional inventory attributes.
+    "availability": "A String", # Optional. [Availability](https://support.google.com/merchants/answer/14644124) of the product in this region.
+    "price": { # The price represented as a number and currency. # Optional. Price of the product in this region.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "salePrice": { # The price represented as a number and currency. # Optional. Sale price of the product in this region. Mandatory if `salePriceEffectiveDate` is defined.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Optional. The `TimePeriod` of the sale price in this region.
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Regional inventory information for the product. Represents specific information like price and availability for a given product in a specific `region`. For a list of all accepted attribute values, see the [regional product inventory data specification](https://support.google.com/merchants/answer/9698880).
+  "account": "A String", # Output only. The account that owns the product. This field will be ignored if set by the client.
+  "name": "A String", # Output only. The name of the `RegionalInventory` resource. Format: `{regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}`
+  "region": "A String", # Required. Immutable. ID of the region for this `RegionalInventory` resource. See the [Regional availability and pricing](https://support.google.com/merchants/answer/9698880) for more details.
+  "regionalInventoryAttributes": { # Regional inventory attributes. # Optional. A list of regional inventory attributes.
+    "availability": "A String", # Optional. [Availability](https://support.google.com/merchants/answer/14644124) of the product in this region.
+    "price": { # The price represented as a number and currency. # Optional. Price of the product in this region.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "salePrice": { # The price represented as a number and currency. # Optional. Sale price of the product in this region. Mandatory if `salePriceEffectiveDate` is defined.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Optional. The `TimePeriod` of the sale price in this region.
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+  },
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists the `RegionalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `RegionalInventory` resources are listed per product for a given account.
+
+Args:
+  parent: string, Required. The `name` of the parent product to list `RegionalInventory` resources for. Format: `accounts/{account}/products/{product}` (required)
+  pageSize: integer, The maximum number of `RegionalInventory` resources for the given product to return. The service returns fewer than this value if the number of inventories for the given product is less that than the `pageSize`. The default value is 25000. The maximum value is 100000; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum.
+  pageToken: string, A page token, received from a previous `ListRegionalInventories` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `ListRegionalInventories` must match the call that provided the page token. The token returned as nextPageToken in the response to the previous request.
+  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 `ListRegionalInventories` method.
+  "nextPageToken": "A String", # A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "regionalInventories": [ # The `RegionalInventory` resources for the given product from the specified account.
+    { # Regional inventory information for the product. Represents specific information like price and availability for a given product in a specific `region`. For a list of all accepted attribute values, see the [regional product inventory data specification](https://support.google.com/merchants/answer/9698880).
+      "account": "A String", # Output only. The account that owns the product. This field will be ignored if set by the client.
+      "name": "A String", # Output only. The name of the `RegionalInventory` resource. Format: `{regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}`
+      "region": "A String", # Required. Immutable. ID of the region for this `RegionalInventory` resource. See the [Regional availability and pricing](https://support.google.com/merchants/answer/9698880) for more details.
+      "regionalInventoryAttributes": { # Regional inventory attributes. # Optional. A list of regional inventory attributes.
+        "availability": "A String", # Optional. [Availability](https://support.google.com/merchants/answer/14644124) of the product in this region.
+        "price": { # The price represented as a number and currency. # Optional. Price of the product in this region.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "salePrice": { # The price represented as a number and currency. # Optional. Sale price of the product in this region. Mandatory if `salePriceEffectiveDate` is defined.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Optional. The `TimePeriod` of the sale price in this region.
+          "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+          "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+        },
+      },
+    },
+  ],
+}

+

+
+

+    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/merchantapi_inventories_v1.html b/docs/dyn/merchantapi_inventories_v1.html
new file mode 100644
index 00000000000..6f950506c5b
--- /dev/null
+++ b/docs/dyn/merchantapi_inventories_v1.html
@@ -0,0 +1,111 @@
+
+
+
+
Merchant API

+
Instance Methods

+

+  accounts()
+

+
Returns the accounts Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  new_batch_http_request()

+
Create a BatchHttpRequest object based on the discovery document.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    new_batch_http_request()
+  
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_issueresolution_v1.accounts.aggregateProductStatuses.html b/docs/dyn/merchantapi_issueresolution_v1.accounts.aggregateProductStatuses.html
new file mode 100644
index 00000000000..61c291be6c1
--- /dev/null
+++ b/docs/dyn/merchantapi_issueresolution_v1.accounts.aggregateProductStatuses.html
@@ -0,0 +1,153 @@
+
+
+
+
Merchant API . accounts . aggregateProductStatuses

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Lists the `AggregateProductStatuses` resources for your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results.

+

+  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 the `AggregateProductStatuses` resources for your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results.
+
+Args:
+  parent: string, Required. The account to list aggregate product statuses for. Format: `accounts/{account}` (required)
+  filter: string, Optional. A filter expression that filters the aggregate product statuses. Filtering is only supported by the `reporting_context` and `country` field. For example: `reporting_context = "SHOPPING_ADS" AND country = "US"`.
+  pageSize: integer, Optional. The maximum number of aggregate product statuses to return. The service may return fewer than this value. If unspecified, at most 25 aggregate product statuses are returned. The maximum value is 250; values above 250 are coerced to 250.
+  pageToken: string, Optional. A page token, received from a previous `ListAggregateProductStatuses` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAggregateProductStatuses` 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 the `ListAggregateProductStatuses` method.
+  "aggregateProductStatuses": [ # The `AggregateProductStatuses` resources for the given account.
+    { # Aggregate product statuses for a given reporting context and country.
+      "country": "A String", # The country of the aggregate product statuses. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
+      "itemLevelIssues": [ # The product issues that affect the given reporting context and country.
+        { # The ItemLevelIssue of the product status.
+          "attribute": "A String", # The attribute's name, if the issue is caused by a single attribute.
+          "code": "A String", # The error code of the issue.
+          "description": "A String", # A short issue description in English.
+          "detail": "A String", # A detailed issue description in English.
+          "documentationUri": "A String", # The URL of a web page to help with resolving this issue.
+          "productCount": "A String", # The number of products affected by this issue.
+          "resolution": "A String", # Whether the issue can be resolved by the merchant.
+          "severity": "A String", # How this issue affects serving of the offer.
+        },
+      ],
+      "name": "A String", # Identifier. The name of the `AggregateProductStatuses` resource. Format: `accounts/{account}/aggregateProductStatuses/{aggregateProductStatuses}`
+      "reportingContext": "A String", # The reporting context of the aggregate product statuses.
+      "stats": { # Products statistics. # Products statistics for the given reporting context and country.
+        "activeCount": "A String", # The number of products that are active.
+        "disapprovedCount": "A String", # The number of products that are disapproved.
+        "expiringCount": "A String", # The number of products that are expiring.
+        "pendingCount": "A String", # The number of products that are pending.
+      },
+    },
+  ],
+  "nextPageToken": "A String", # A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+}

+

+
+

+    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/merchantapi_issueresolution_v1.accounts.html b/docs/dyn/merchantapi_issueresolution_v1.accounts.html
new file mode 100644
index 00000000000..34a81a00718
--- /dev/null
+++ b/docs/dyn/merchantapi_issueresolution_v1.accounts.html
@@ -0,0 +1,91 @@
+
+
+
+
Merchant API . accounts

+
Instance Methods

+

+  aggregateProductStatuses()
+

+
Returns the aggregateProductStatuses Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_issueresolution_v1.html b/docs/dyn/merchantapi_issueresolution_v1.html
new file mode 100644
index 00000000000..2cfa69be2f8
--- /dev/null
+++ b/docs/dyn/merchantapi_issueresolution_v1.html
@@ -0,0 +1,116 @@
+
+
+
+
Merchant API

+
Instance Methods

+

+  accounts()
+

+
Returns the accounts Resource.

+
+

+  issueresolution()
+

+
Returns the issueresolution Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  new_batch_http_request()

+
Create a BatchHttpRequest object based on the discovery document.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    new_batch_http_request()
+  
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_issueresolution_v1.issueresolution.html b/docs/dyn/merchantapi_issueresolution_v1.issueresolution.html
new file mode 100644
index 00000000000..44b0e88b4d1
--- /dev/null
+++ b/docs/dyn/merchantapi_issueresolution_v1.issueresolution.html
@@ -0,0 +1,417 @@
+
+
+
+
Merchant API . issueresolution

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  renderaccountissues(name, body=None, languageCode=None, timeZone=None, x__xgafv=None)

+
Provide a list of business's account issues with an issue resolution content and available actions. This content and actions are meant to be rendered and shown in third-party applications.

+

+  renderproductissues(name, body=None, languageCode=None, timeZone=None, x__xgafv=None)

+
Provide a list of issues for business's product with an issue resolution content and available actions. This content and actions are meant to be rendered and shown in third-party applications.

+

+  triggeraction(name, body=None, languageCode=None, x__xgafv=None)

+
Start an action. The action can be requested by a business in third-party application. Before the business can request the action, the third-party application needs to show them action specific content and display a user input form. The action can be successfully started only once all `required` inputs are provided. If any `required` input is missing, or invalid value was provided, the service will return 400 error. Validation errors will contain Ids for all problematic field together with translated, human readable error messages that can be shown to the user.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    renderaccountissues(name, body=None, languageCode=None, timeZone=None, x__xgafv=None)
+  
Provide a list of business's account issues with an issue resolution content and available actions. This content and actions are meant to be rendered and shown in third-party applications.
+
+Args:
+  name: string, Required. The account to fetch issues for. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The payload for configuring how the content should be rendered.
+  "contentOption": "A String", # Optional. How the detailed content should be returned. Default option is to return the content as a pre-rendered HTML text.
+  "userInputActionOption": "A String", # Optional. How actions with user input form should be handled. If not provided, actions will be returned as links that points the business to Merchant Center where they can request the action.
+}
+
+  languageCode: string, Optional. The [IETF BCP-47](https://tools.ietf.org/html/bcp47) language code used to localize issue resolution content. If not set, the result will be in default language `en-US`.
+  timeZone: string, Optional. The [IANA](https://www.iana.org/time-zones) timezone used to localize times in an issue resolution content. For example 'America/Los_Angeles'. If not set, results will use as a default UTC.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response containing an issue resolution content and actions for listed account issues.
+  "renderedIssues": [ # List of account issues for a given account. This list can be shown with compressed, expandable items. In the compressed form, the title and impact should be shown for each issue. Once the issue is expanded, the detailed content and available actions should be rendered.
+    { # An issue affecting specific business or their product.
+      "actions": [ # A list of actionable steps that can be executed to solve the issue. An example is requesting a re-review or providing arguments when business disagrees with the issue. Actions that are supported in (your) third-party application can be rendered as buttons and should be available to the business when they expand the issue.
+        { # An actionable step that can be executed to solve the issue.
+          "builtinSimpleAction": { # Action that is implemented and performed in (your) third-party application. Represents various functionality that is expected to be available to business and will help them with resolving the issue. The application should point the business to the place, where they can access the corresponding functionality. If the functionality is not supported, it is recommended to explain the situation to the business and provide them with instructions how to solve the issue. # Action implemented and performed in (your) third-party application. The application should point the business to the place, where they can access the corresponding functionality or provide instructions, if the specific functionality is not available.
+            "additionalContent": { # Long text from external source. # Long text from an external source that should be available to the business. Present when the type is `SHOW_ADDITIONAL_CONTENT`.
+              "paragraphs": [ # Long text organized into paragraphs.
+                "A String",
+              ],
+              "title": "A String", # Title of the additional content;
+            },
+            "attributeCode": "A String", # The attribute that needs to be updated. Present when the type is `EDIT_ITEM_ATTRIBUTE`. This field contains a code for attribute, represented in snake_case. You can find a list of product's attributes, with their codes [here](https://support.google.com/merchants/answer/7052112).
+            "type": "A String", # The type of action that represents a functionality that is expected to be available in third-party application.
+          },
+          "builtinUserInputAction": { # Action that is implemented and performed in (your) third-party application. The application needs to show an additional content and input form to the business. They can start the action only when they provided all required inputs. The application will request processing of the action by calling the [triggeraction method](https://developers.google.com/merchant/api/reference/rest/issueresolution_v1beta/issueresolution/triggeraction). # Action implemented and performed in (your) third-party application. The application needs to show an additional content and input form to the business as specified for given action. They can trigger the action only when they provided all required inputs.
+            "actionContext": "A String", # Contains the action's context that must be included as part of the TriggerActionPayload.action_context in TriggerActionRequest.payload to call the `triggeraction` method. The content should be treated as opaque and must not be modified.
+            "flows": [ # Actions may provide multiple different flows. Business selects one that fits best to their intent. Selecting the flow is the first step in user's interaction with the action. It affects what input fields will be available and required and also how the request will be processed.
+              { # Flow that can be selected for an action. When a business selects a flow, application should open a dialog with more information and input form.
+                "dialogButtonLabel": "A String", # Label for the button to trigger the action from the action dialog. For example: "Request review"
+                "dialogCallout": { # An important message that should be highlighted. Usually displayed as a banner. # Important message to be highlighted in the request dialog. For example: "You can only request a review for disagreeing with this issue once. If it's not approved, you'll need to fix the issue and wait a few days before you can request another review."
+                  "fullMessage": { # Block of text that may contain a tooltip with more information. # A full message that needs to be shown to the business.
+                    "simpleTooltipValue": "A String", # Value of the tooltip as a simple text.
+                    "simpleValue": "A String", # Value of the message as a simple text.
+                    "tooltipIconStyle": "A String", # The suggested type of an icon for tooltip, if a tooltip is present.
+                  },
+                  "styleHint": "A String", # Can be used to render messages with different severity in different styles. Snippets off all types contain important information that should be displayed to the business.
+                },
+                "dialogMessage": { # Block of text that may contain a tooltip with more information. # Message displayed in the request dialog. For example: "Make sure you've fixed all your country-specific issues. If not, you may have to wait 7 days to request another review". There may be an more information to be shown in a tooltip.
+                  "simpleTooltipValue": "A String", # Value of the tooltip as a simple text.
+                  "simpleValue": "A String", # Value of the message as a simple text.
+                  "tooltipIconStyle": "A String", # The suggested type of an icon for tooltip, if a tooltip is present.
+                },
+                "dialogTitle": "A String", # Title of the request dialog. For example: "Before you request a review"
+                "id": "A String", # Not for display but need to be sent back for the selected action flow.
+                "inputs": [ # A list of input fields.
+                  { # Input field that needs to be available to the business. If the field is marked as required, then a value needs to be provided for a successful processing of the request.
+                    "checkboxInput": { # Checkbox input allows the business to provide a boolean value. Corresponds to the [html input type=checkbox](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.checkbox.html#input.checkbox). If the business checks the box, the input value for the field is `true`, otherwise it is `false`. This type of input is often used as a confirmation that the business completed required steps before they are allowed to start the action. In such a case, the input field is marked as required and the button to trigger the action should stay disabled until the business checks the box. # Input field to provide a boolean value. Corresponds to the [html input type=checkbox](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.checkbox.html#input.checkbox).
+                    },
+                    "choiceInput": { # Choice input allows the business to select one of the offered choices. Some choices may be linked to additional input fields that should be displayed under or next to the choice option. The value for the additional input field needs to be provided only when the specific choice is selected by the the business. For example, additional input field can be hidden or disabled until the business selects the specific choice. # Input field to select one of the offered choices. Corresponds to the [html input type=radio](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.radio.html#input.radio).
+                      "options": [ # A list of choices. Only one option can be selected.
+                        { # A choice that the business can select.
+                          "additionalInput": # Object with schema name: InputField # Input that should be displayed when this option is selected. The additional input will not contain a `ChoiceInput`.
+                          "id": "A String", # Not for display but need to be sent back for the selected choice option.
+                          "label": { # Block of text that may contain a tooltip with more information. # Short description of the choice option. There may be more information to be shown as a tooltip.
+                            "simpleTooltipValue": "A String", # Value of the tooltip as a simple text.
+                            "simpleValue": "A String", # Value of the message as a simple text.
+                            "tooltipIconStyle": "A String", # The suggested type of an icon for tooltip, if a tooltip is present.
+                          },
+                        },
+                      ],
+                    },
+                    "id": "A String", # Not for display but need to be sent back for the given input field.
+                    "label": { # Block of text that may contain a tooltip with more information. # Input field label. There may be more information to be shown in a tooltip.
+                      "simpleTooltipValue": "A String", # Value of the tooltip as a simple text.
+                      "simpleValue": "A String", # Value of the message as a simple text.
+                      "tooltipIconStyle": "A String", # The suggested type of an icon for tooltip, if a tooltip is present.
+                    },
+                    "required": True or False, # Whether the field is required. The action button needs to stay disabled till values for all required fields are provided.
+                    "textInput": { # Text input allows the business to provide a text value. # Input field to provide text information. Corresponds to the [html input type=text](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.text.html#input.text) or [html textarea](https://www.w3.org/TR/2012/WD-html-markup-20121025/textarea.html#textarea).
+                      "additionalInfo": { # Block of text that may contain a tooltip with more information. # Additional info regarding the field to be displayed to the business. For example, warning to not include personal identifiable information. There may be more information to be shown in a tooltip.
+                        "simpleTooltipValue": "A String", # Value of the tooltip as a simple text.
+                        "simpleValue": "A String", # Value of the message as a simple text.
+                        "tooltipIconStyle": "A String", # The suggested type of an icon for tooltip, if a tooltip is present.
+                      },
+                      "ariaLabel": "A String", # Text to be used as the [aria-label](https://www.w3.org/TR/WCAG20-TECHS/ARIA14.html) for the input.
+                      "formatInfo": "A String", # Information about the required format. If present, it should be shown close to the input field to help the business to provide a correct value. For example: "VAT numbers should be in a format similar to SK9999999999"
+                      "type": "A String", # Type of the text input
+                    },
+                  },
+                ],
+                "label": "A String", # Text value describing the intent for the action flow. It can be used as an input label if business needs to pick one of multiple flows. For example: "I disagree with the issue"
+              },
+            ],
+          },
+          "buttonLabel": "A String", # Label of the action button.
+          "externalAction": { # Action that is implemented and performed outside of the third-party application. It should redirect the business to the provided URL of an external system where they can perform the action. For example to request a review in the Merchant Center. # Action that is implemented and performed outside of (your) third-party application. The application needs to redirect the business to the external location where they can perform the action.
+            "type": "A String", # The type of external action.
+            "uri": "A String", # URL to external system, for example Merchant Center, where the business can perform the action.
+          },
+          "isAvailable": True or False, # Controlling whether the button is active or disabled. The value is 'false' when the action was already requested or is not available. If the action is not available then a reason will be present. If (your) third-party application shows a disabled button for action that is not available, then it should also show reasons.
+          "reasons": [ # List of reasons why the action is not available. The list of reasons is empty if the action is available. If there is only one reason, it can be displayed next to the disabled button. If there are more reasons, all of them should be displayed, for example in a pop-up dialog.
+            { # A single reason why the action is not available.
+              "action": # Object with schema name: Action # Optional. An action that needs to be performed to solve the problem represented by this reason. This action will always be available. Should be rendered as a link or button next to the summarizing message. For example, the review may be available only once the business configure all required attributes. In such a situation this action can be a link to the form, where they can fill the missing attribute to unblock the main action.
+              "detail": "A String", # Detailed explanation of the reason. Should be displayed as a hint if present.
+              "message": "A String", # Messages summarizing the reason, why the action is not available. For example: "Review requested on Jan 03. Review requests can take a few days to complete."
+            },
+          ],
+        },
+      ],
+      "impact": { # Overall impact of the issue. # Clarifies the severity of the issue. The summarizing message, if present, should be shown right under the title for each issue. It helps business to quickly understand the impact of the issue. The detailed breakdown helps the business to fully understand the impact of the issue. It can be rendered as dialog that opens when the business mouse over the summarized impact statement. Issues with different severity can be styled differently. They may use a different color or icon to signal the difference between `ERROR`, `WARNING` and `INFO`.
+        "breakdowns": [ # Detailed impact breakdown. Explains the types of restriction the issue has in different shopping destinations and territory. If present, it should be rendered to the business. Can be shown as a mouse over dropdown or a dialog. Each breakdown item represents a group of regions with the same impact details.
+          { # A detailed impact breakdown for a group of regions where the impact of the issue on different shopping destinations is the same.
+            "details": [ # Human readable, localized description of issue's effect on different targets. Should be rendered as a list. For example: * "Products not showing in ads" * "Products not showing organically"
+              "A String",
+            ],
+            "regions": [ # Lists of regions. Should be rendered as a title for this group of details. The full list should be shown to the business. If the list is too long, it is recommended to make it expandable.
+              { # Region with code and localized name.
+                "code": "A String", # The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml)
+                "name": "A String", # The localized name of the region. For region with code='001' the value is 'All countries' or the equivalent in other languages.
+              },
+            ],
+          },
+        ],
+        "message": "A String", # Optional. Message summarizing the overall impact of the issue. If present, it should be rendered to the business. For example: "Disapproves 90k offers in 25 countries"
+        "severity": "A String", # The severity of the issue.
+      },
+      "prerenderedContent": "A String", # Details of the issue as a pre-rendered HTML. HTML elements contain CSS classes that can be used to customize the style of the content. Always sanitize the HTML before embedding it directly to your application. The sanitizer needs to allow basic HTML tags, such as: `div`, `span`, `p`, `a`, `ul`, `li`, `table`, `tr`, `td`. For example, you can use [DOMPurify](https://www.npmjs.com/package/dompurify). CSS classes: * `issue-detail` - top level container for the detail of the issue * `callout-banners` - section of the `issue-detail` with callout banners * `callout-banner` - single callout banner, inside `callout-banners` * `callout-banner-info` - callout with important information (default) * `callout-banner-warning` - callout with a warning * `callout-banner-error` - callout informing about an error (most severe) * `issue-content` - section of the `issue-detail`, contains multiple `content-element` * `content-element` - content element such as a list, link or paragraph, inside `issue-content` * `root-causes` - unordered list with items describing root causes of the issue, inside `issue-content` * `root-causes-intro` - intro text before the `root-causes` list, inside `issue-content` * `segment` - section of the text, `span` inside paragraph * `segment-attribute` - section of the text that represents a product attribute, for example 'image\_link' * `segment-literal` - section of the text that contains a special value, for example '0-1000 kg' * `segment-bold` - section of the text that should be rendered as bold * `segment-italic` - section of the text that should be rendered as italic * `tooltip` - used on paragraphs that should be rendered with a tooltip. A section of the text in such a paragraph will have a class `tooltip-text` and is intended to be shown in a mouse over dialog. If the style is not used, the `tooltip-text` section would be shown on a new line, after the main part of the text. * `tooltip-text` - marks a section of the text within a `tooltip`, that is intended to be shown in a mouse over dialog. * `tooltip-icon` - marks a section of the text within a `tooltip`, that can be replaced with a tooltip icon, for example '?' or 'i'. By default, this section contains a `br` tag, that is separating the main text and the tooltip text when the style is not used. * `tooltip-style-question` - the tooltip shows helpful information, can use the '?' as an icon. * `tooltip-style-info` - the tooltip adds additional information fitting to the context, can use the 'i' as an icon. * `content-moderation` - marks the paragraph that explains how the issue was identified. * `new-element` - Present for new elements added to the pre-rendered content in the future. To make sure that a new content element does not break your style, you can hide everything with this class.
+      "prerenderedOutOfCourtDisputeSettlement": "A String", # Pre-rendered HTML that contains a link to the external location where the ODS can be requested and instructions for how to request it. HTML elements contain CSS classes that can be used to customize the style of this snippet. Always sanitize the HTML before embedding it directly to your application. The sanitizer needs to allow basic HTML tags, such as: `div`, `span`, `p`, `a`, `ul`, `li`, `table`, `tr`, `td`. For example, you can use [DOMPurify](https://www.npmjs.com/package/dompurify). CSS classes: * `ods-section`* - wrapper around the out-of-court dispute resolution section * `ods-description`* - intro text for the out-of-court dispute resolution. It may contain multiple segments and a link. * `ods-param`* - wrapper around the header-value pair for parameters that the business may need to provide during the ODS process. * `ods-routing-id`* - ods param for the Routing ID. * `ods-reference-id`* - ods param for the Routing ID. * `ods-param-header`* - header for the ODS parameter * `ods-param-value`* - value of the ODS parameter. This value should be rendered in a way that it is easy for the user to identify and copy. * `segment` - section of the text, `span` inside paragraph * `segment-attribute` - section of the text that represents a product attribute, for example 'image\_link' * `segment-literal` - section of the text that contains a special value, for example '0-1000 kg' * `segment-bold` - section of the text that should be rendered as bold * `segment-italic` - section of the text that should be rendered as italic * `tooltip` - used on paragraphs that should be rendered with a tooltip. A section of the text in such a paragraph will have a class `tooltip-text` and is intended to be shown in a mouse over dialog. If the style is not used, the `tooltip-text` section would be shown on a new line, after the main part of the text. * `tooltip-text` - marks a section of the text within a `tooltip`, that is intended to be shown in a mouse over dialog. * `tooltip-icon` - marks a section of the text within a `tooltip`, that can be replaced with a tooltip icon, for example '?' or 'i'. By default, this section contains a `br` tag, that is separating the main text and the tooltip text when the style is not used. * `tooltip-style-question` - the tooltip shows helpful information, can use the '?' as an icon. * `tooltip-style-info` - the tooltip adds additional information fitting to the context, can use the 'i' as an icon.
+      "title": "A String", # Title of the issue.
+    },
+  ],
+}

+

+
+

+    renderproductissues(name, body=None, languageCode=None, timeZone=None, x__xgafv=None)
+  
Provide a list of issues for business's product with an issue resolution content and available actions. This content and actions are meant to be rendered and shown in third-party applications.
+
+Args:
+  name: string, Required. The name of the product to fetch issues for. Format: `accounts/{account}/products/{product}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The payload for configuring how the content should be rendered.
+  "contentOption": "A String", # Optional. How the detailed content should be returned. Default option is to return the content as a pre-rendered HTML text.
+  "userInputActionOption": "A String", # Optional. How actions with user input form should be handled. If not provided, actions will be returned as links that points the business to Merchant Center where they can request the action.
+}
+
+  languageCode: string, Optional. The [IETF BCP-47](https://tools.ietf.org/html/bcp47) language code used to localize an issue resolution content. If not set, the result will be in default language `en-US`.
+  timeZone: string, Optional. The [IANA](https://www.iana.org/time-zones) timezone used to localize times in an issue resolution content. For example 'America/Los_Angeles'. If not set, results will use as a default UTC.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response containing an issue resolution content and actions for listed product issues.
+  "renderedIssues": [ # List of issues for a given product. This list can be shown with compressed, expandable items. In the compressed form, the title and impact should be shown for each issue. Once the issue is expanded, the detailed content and available actions should be rendered.
+    { # An issue affecting specific business or their product.
+      "actions": [ # A list of actionable steps that can be executed to solve the issue. An example is requesting a re-review or providing arguments when business disagrees with the issue. Actions that are supported in (your) third-party application can be rendered as buttons and should be available to the business when they expand the issue.
+        { # An actionable step that can be executed to solve the issue.
+          "builtinSimpleAction": { # Action that is implemented and performed in (your) third-party application. Represents various functionality that is expected to be available to business and will help them with resolving the issue. The application should point the business to the place, where they can access the corresponding functionality. If the functionality is not supported, it is recommended to explain the situation to the business and provide them with instructions how to solve the issue. # Action implemented and performed in (your) third-party application. The application should point the business to the place, where they can access the corresponding functionality or provide instructions, if the specific functionality is not available.
+            "additionalContent": { # Long text from external source. # Long text from an external source that should be available to the business. Present when the type is `SHOW_ADDITIONAL_CONTENT`.
+              "paragraphs": [ # Long text organized into paragraphs.
+                "A String",
+              ],
+              "title": "A String", # Title of the additional content;
+            },
+            "attributeCode": "A String", # The attribute that needs to be updated. Present when the type is `EDIT_ITEM_ATTRIBUTE`. This field contains a code for attribute, represented in snake_case. You can find a list of product's attributes, with their codes [here](https://support.google.com/merchants/answer/7052112).
+            "type": "A String", # The type of action that represents a functionality that is expected to be available in third-party application.
+          },
+          "builtinUserInputAction": { # Action that is implemented and performed in (your) third-party application. The application needs to show an additional content and input form to the business. They can start the action only when they provided all required inputs. The application will request processing of the action by calling the [triggeraction method](https://developers.google.com/merchant/api/reference/rest/issueresolution_v1beta/issueresolution/triggeraction). # Action implemented and performed in (your) third-party application. The application needs to show an additional content and input form to the business as specified for given action. They can trigger the action only when they provided all required inputs.
+            "actionContext": "A String", # Contains the action's context that must be included as part of the TriggerActionPayload.action_context in TriggerActionRequest.payload to call the `triggeraction` method. The content should be treated as opaque and must not be modified.
+            "flows": [ # Actions may provide multiple different flows. Business selects one that fits best to their intent. Selecting the flow is the first step in user's interaction with the action. It affects what input fields will be available and required and also how the request will be processed.
+              { # Flow that can be selected for an action. When a business selects a flow, application should open a dialog with more information and input form.
+                "dialogButtonLabel": "A String", # Label for the button to trigger the action from the action dialog. For example: "Request review"
+                "dialogCallout": { # An important message that should be highlighted. Usually displayed as a banner. # Important message to be highlighted in the request dialog. For example: "You can only request a review for disagreeing with this issue once. If it's not approved, you'll need to fix the issue and wait a few days before you can request another review."
+                  "fullMessage": { # Block of text that may contain a tooltip with more information. # A full message that needs to be shown to the business.
+                    "simpleTooltipValue": "A String", # Value of the tooltip as a simple text.
+                    "simpleValue": "A String", # Value of the message as a simple text.
+                    "tooltipIconStyle": "A String", # The suggested type of an icon for tooltip, if a tooltip is present.
+                  },
+                  "styleHint": "A String", # Can be used to render messages with different severity in different styles. Snippets off all types contain important information that should be displayed to the business.
+                },
+                "dialogMessage": { # Block of text that may contain a tooltip with more information. # Message displayed in the request dialog. For example: "Make sure you've fixed all your country-specific issues. If not, you may have to wait 7 days to request another review". There may be an more information to be shown in a tooltip.
+                  "simpleTooltipValue": "A String", # Value of the tooltip as a simple text.
+                  "simpleValue": "A String", # Value of the message as a simple text.
+                  "tooltipIconStyle": "A String", # The suggested type of an icon for tooltip, if a tooltip is present.
+                },
+                "dialogTitle": "A String", # Title of the request dialog. For example: "Before you request a review"
+                "id": "A String", # Not for display but need to be sent back for the selected action flow.
+                "inputs": [ # A list of input fields.
+                  { # Input field that needs to be available to the business. If the field is marked as required, then a value needs to be provided for a successful processing of the request.
+                    "checkboxInput": { # Checkbox input allows the business to provide a boolean value. Corresponds to the [html input type=checkbox](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.checkbox.html#input.checkbox). If the business checks the box, the input value for the field is `true`, otherwise it is `false`. This type of input is often used as a confirmation that the business completed required steps before they are allowed to start the action. In such a case, the input field is marked as required and the button to trigger the action should stay disabled until the business checks the box. # Input field to provide a boolean value. Corresponds to the [html input type=checkbox](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.checkbox.html#input.checkbox).
+                    },
+                    "choiceInput": { # Choice input allows the business to select one of the offered choices. Some choices may be linked to additional input fields that should be displayed under or next to the choice option. The value for the additional input field needs to be provided only when the specific choice is selected by the the business. For example, additional input field can be hidden or disabled until the business selects the specific choice. # Input field to select one of the offered choices. Corresponds to the [html input type=radio](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.radio.html#input.radio).
+                      "options": [ # A list of choices. Only one option can be selected.
+                        { # A choice that the business can select.
+                          "additionalInput": # Object with schema name: InputField # Input that should be displayed when this option is selected. The additional input will not contain a `ChoiceInput`.
+                          "id": "A String", # Not for display but need to be sent back for the selected choice option.
+                          "label": { # Block of text that may contain a tooltip with more information. # Short description of the choice option. There may be more information to be shown as a tooltip.
+                            "simpleTooltipValue": "A String", # Value of the tooltip as a simple text.
+                            "simpleValue": "A String", # Value of the message as a simple text.
+                            "tooltipIconStyle": "A String", # The suggested type of an icon for tooltip, if a tooltip is present.
+                          },
+                        },
+                      ],
+                    },
+                    "id": "A String", # Not for display but need to be sent back for the given input field.
+                    "label": { # Block of text that may contain a tooltip with more information. # Input field label. There may be more information to be shown in a tooltip.
+                      "simpleTooltipValue": "A String", # Value of the tooltip as a simple text.
+                      "simpleValue": "A String", # Value of the message as a simple text.
+                      "tooltipIconStyle": "A String", # The suggested type of an icon for tooltip, if a tooltip is present.
+                    },
+                    "required": True or False, # Whether the field is required. The action button needs to stay disabled till values for all required fields are provided.
+                    "textInput": { # Text input allows the business to provide a text value. # Input field to provide text information. Corresponds to the [html input type=text](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.text.html#input.text) or [html textarea](https://www.w3.org/TR/2012/WD-html-markup-20121025/textarea.html#textarea).
+                      "additionalInfo": { # Block of text that may contain a tooltip with more information. # Additional info regarding the field to be displayed to the business. For example, warning to not include personal identifiable information. There may be more information to be shown in a tooltip.
+                        "simpleTooltipValue": "A String", # Value of the tooltip as a simple text.
+                        "simpleValue": "A String", # Value of the message as a simple text.
+                        "tooltipIconStyle": "A String", # The suggested type of an icon for tooltip, if a tooltip is present.
+                      },
+                      "ariaLabel": "A String", # Text to be used as the [aria-label](https://www.w3.org/TR/WCAG20-TECHS/ARIA14.html) for the input.
+                      "formatInfo": "A String", # Information about the required format. If present, it should be shown close to the input field to help the business to provide a correct value. For example: "VAT numbers should be in a format similar to SK9999999999"
+                      "type": "A String", # Type of the text input
+                    },
+                  },
+                ],
+                "label": "A String", # Text value describing the intent for the action flow. It can be used as an input label if business needs to pick one of multiple flows. For example: "I disagree with the issue"
+              },
+            ],
+          },
+          "buttonLabel": "A String", # Label of the action button.
+          "externalAction": { # Action that is implemented and performed outside of the third-party application. It should redirect the business to the provided URL of an external system where they can perform the action. For example to request a review in the Merchant Center. # Action that is implemented and performed outside of (your) third-party application. The application needs to redirect the business to the external location where they can perform the action.
+            "type": "A String", # The type of external action.
+            "uri": "A String", # URL to external system, for example Merchant Center, where the business can perform the action.
+          },
+          "isAvailable": True or False, # Controlling whether the button is active or disabled. The value is 'false' when the action was already requested or is not available. If the action is not available then a reason will be present. If (your) third-party application shows a disabled button for action that is not available, then it should also show reasons.
+          "reasons": [ # List of reasons why the action is not available. The list of reasons is empty if the action is available. If there is only one reason, it can be displayed next to the disabled button. If there are more reasons, all of them should be displayed, for example in a pop-up dialog.
+            { # A single reason why the action is not available.
+              "action": # Object with schema name: Action # Optional. An action that needs to be performed to solve the problem represented by this reason. This action will always be available. Should be rendered as a link or button next to the summarizing message. For example, the review may be available only once the business configure all required attributes. In such a situation this action can be a link to the form, where they can fill the missing attribute to unblock the main action.
+              "detail": "A String", # Detailed explanation of the reason. Should be displayed as a hint if present.
+              "message": "A String", # Messages summarizing the reason, why the action is not available. For example: "Review requested on Jan 03. Review requests can take a few days to complete."
+            },
+          ],
+        },
+      ],
+      "impact": { # Overall impact of the issue. # Clarifies the severity of the issue. The summarizing message, if present, should be shown right under the title for each issue. It helps business to quickly understand the impact of the issue. The detailed breakdown helps the business to fully understand the impact of the issue. It can be rendered as dialog that opens when the business mouse over the summarized impact statement. Issues with different severity can be styled differently. They may use a different color or icon to signal the difference between `ERROR`, `WARNING` and `INFO`.
+        "breakdowns": [ # Detailed impact breakdown. Explains the types of restriction the issue has in different shopping destinations and territory. If present, it should be rendered to the business. Can be shown as a mouse over dropdown or a dialog. Each breakdown item represents a group of regions with the same impact details.
+          { # A detailed impact breakdown for a group of regions where the impact of the issue on different shopping destinations is the same.
+            "details": [ # Human readable, localized description of issue's effect on different targets. Should be rendered as a list. For example: * "Products not showing in ads" * "Products not showing organically"
+              "A String",
+            ],
+            "regions": [ # Lists of regions. Should be rendered as a title for this group of details. The full list should be shown to the business. If the list is too long, it is recommended to make it expandable.
+              { # Region with code and localized name.
+                "code": "A String", # The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml)
+                "name": "A String", # The localized name of the region. For region with code='001' the value is 'All countries' or the equivalent in other languages.
+              },
+            ],
+          },
+        ],
+        "message": "A String", # Optional. Message summarizing the overall impact of the issue. If present, it should be rendered to the business. For example: "Disapproves 90k offers in 25 countries"
+        "severity": "A String", # The severity of the issue.
+      },
+      "prerenderedContent": "A String", # Details of the issue as a pre-rendered HTML. HTML elements contain CSS classes that can be used to customize the style of the content. Always sanitize the HTML before embedding it directly to your application. The sanitizer needs to allow basic HTML tags, such as: `div`, `span`, `p`, `a`, `ul`, `li`, `table`, `tr`, `td`. For example, you can use [DOMPurify](https://www.npmjs.com/package/dompurify). CSS classes: * `issue-detail` - top level container for the detail of the issue * `callout-banners` - section of the `issue-detail` with callout banners * `callout-banner` - single callout banner, inside `callout-banners` * `callout-banner-info` - callout with important information (default) * `callout-banner-warning` - callout with a warning * `callout-banner-error` - callout informing about an error (most severe) * `issue-content` - section of the `issue-detail`, contains multiple `content-element` * `content-element` - content element such as a list, link or paragraph, inside `issue-content` * `root-causes` - unordered list with items describing root causes of the issue, inside `issue-content` * `root-causes-intro` - intro text before the `root-causes` list, inside `issue-content` * `segment` - section of the text, `span` inside paragraph * `segment-attribute` - section of the text that represents a product attribute, for example 'image\_link' * `segment-literal` - section of the text that contains a special value, for example '0-1000 kg' * `segment-bold` - section of the text that should be rendered as bold * `segment-italic` - section of the text that should be rendered as italic * `tooltip` - used on paragraphs that should be rendered with a tooltip. A section of the text in such a paragraph will have a class `tooltip-text` and is intended to be shown in a mouse over dialog. If the style is not used, the `tooltip-text` section would be shown on a new line, after the main part of the text. * `tooltip-text` - marks a section of the text within a `tooltip`, that is intended to be shown in a mouse over dialog. * `tooltip-icon` - marks a section of the text within a `tooltip`, that can be replaced with a tooltip icon, for example '?' or 'i'. By default, this section contains a `br` tag, that is separating the main text and the tooltip text when the style is not used. * `tooltip-style-question` - the tooltip shows helpful information, can use the '?' as an icon. * `tooltip-style-info` - the tooltip adds additional information fitting to the context, can use the 'i' as an icon. * `content-moderation` - marks the paragraph that explains how the issue was identified. * `new-element` - Present for new elements added to the pre-rendered content in the future. To make sure that a new content element does not break your style, you can hide everything with this class.
+      "prerenderedOutOfCourtDisputeSettlement": "A String", # Pre-rendered HTML that contains a link to the external location where the ODS can be requested and instructions for how to request it. HTML elements contain CSS classes that can be used to customize the style of this snippet. Always sanitize the HTML before embedding it directly to your application. The sanitizer needs to allow basic HTML tags, such as: `div`, `span`, `p`, `a`, `ul`, `li`, `table`, `tr`, `td`. For example, you can use [DOMPurify](https://www.npmjs.com/package/dompurify). CSS classes: * `ods-section`* - wrapper around the out-of-court dispute resolution section * `ods-description`* - intro text for the out-of-court dispute resolution. It may contain multiple segments and a link. * `ods-param`* - wrapper around the header-value pair for parameters that the business may need to provide during the ODS process. * `ods-routing-id`* - ods param for the Routing ID. * `ods-reference-id`* - ods param for the Routing ID. * `ods-param-header`* - header for the ODS parameter * `ods-param-value`* - value of the ODS parameter. This value should be rendered in a way that it is easy for the user to identify and copy. * `segment` - section of the text, `span` inside paragraph * `segment-attribute` - section of the text that represents a product attribute, for example 'image\_link' * `segment-literal` - section of the text that contains a special value, for example '0-1000 kg' * `segment-bold` - section of the text that should be rendered as bold * `segment-italic` - section of the text that should be rendered as italic * `tooltip` - used on paragraphs that should be rendered with a tooltip. A section of the text in such a paragraph will have a class `tooltip-text` and is intended to be shown in a mouse over dialog. If the style is not used, the `tooltip-text` section would be shown on a new line, after the main part of the text. * `tooltip-text` - marks a section of the text within a `tooltip`, that is intended to be shown in a mouse over dialog. * `tooltip-icon` - marks a section of the text within a `tooltip`, that can be replaced with a tooltip icon, for example '?' or 'i'. By default, this section contains a `br` tag, that is separating the main text and the tooltip text when the style is not used. * `tooltip-style-question` - the tooltip shows helpful information, can use the '?' as an icon. * `tooltip-style-info` - the tooltip adds additional information fitting to the context, can use the 'i' as an icon.
+      "title": "A String", # Title of the issue.
+    },
+  ],
+}

+

+
+

+    triggeraction(name, body=None, languageCode=None, x__xgafv=None)
+  
Start an action. The action can be requested by a business in third-party application. Before the business can request the action, the third-party application needs to show them action specific content and display a user input form. The action can be successfully started only once all `required` inputs are provided. If any `required` input is missing, or invalid value was provided, the service will return 400 error. Validation errors will contain Ids for all problematic field together with translated, human readable error messages that can be shown to the user.
+
+Args:
+  name: string, Required. The business's account that is triggering the action. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The payload for the triggered action.
+  "actionContext": "A String", # Required. The context from the selected action. The value is obtained from rendered issues and needs to be sent back to identify the action that is being triggered.
+  "actionInput": { # Input provided by the business. # Required. Input provided by the business.
+    "actionFlowId": "A String", # Required. Id of the selected action flow.
+    "inputValues": [ # Required. Values for input fields.
+      { # Input provided by the business for input field.
+        "checkboxInputValue": { # Value for checkbox input field. # Value for checkbox input field.
+          "value": True or False, # Required. True if the business checked the box field. False otherwise.
+        },
+        "choiceInputValue": { # Value for choice input field. # Value for choice input field.
+          "choiceInputOptionId": "A String", # Required. Id of the option that was selected by the business.
+        },
+        "inputFieldId": "A String", # Required. Id of the corresponding input field.
+        "textInputValue": { # Value for text input field. # Value for text input field.
+          "value": "A String", # Required. Text provided by the business.
+        },
+      },
+    ],
+  },
+}
+
+  languageCode: string, Optional. Language code [IETF BCP 47 syntax](https://tools.ietf.org/html/bcp47) used to localize the response. If not set, the result will be in default language `en-US`.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response informing about the started action.
+  "message": "A String", # The message for the business.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_lfp_v1beta.accounts.lfpStores.html b/docs/dyn/merchantapi_lfp_v1beta.accounts.lfpStores.html
index 1e765f8c3fe..5ee960e04ee 100644
--- a/docs/dyn/merchantapi_lfp_v1beta.accounts.lfpStores.html
+++ b/docs/dyn/merchantapi_lfp_v1beta.accounts.lfpStores.html
@@ -131,7 +131,7 @@ 
Method Details

   An object of the form:
 
     { # A store for the merchant. This will be used to match to a store under the Google Business Profile of the target merchant. If a matching store can't be found, the inventories or sales submitted with the store code will not be used.
-  "gcidCategory": [ # Optional. [Google My Business category id](https://gcid-explorer.corp.google.com/static/gcid.html).
+  "gcidCategory": [ # Optional. [Google My Business category id](https://support.google.com/business/answer/7249669).
     "A String",
   ],
   "matchingState": "A String", # Optional. Output only. The state of matching to a Google Business Profile. See matchingStateHint for further details if no match is found.
@@ -157,7 +157,7 @@ 
Method Details

     The object takes the form of:
 
 { # A store for the merchant. This will be used to match to a store under the Google Business Profile of the target merchant. If a matching store can't be found, the inventories or sales submitted with the store code will not be used.
-  "gcidCategory": [ # Optional. [Google My Business category id](https://gcid-explorer.corp.google.com/static/gcid.html).
+  "gcidCategory": [ # Optional. [Google My Business category id](https://support.google.com/business/answer/7249669).
     "A String",
   ],
   "matchingState": "A String", # Optional. Output only. The state of matching to a Google Business Profile. See matchingStateHint for further details if no match is found.
@@ -181,7 +181,7 @@ 
Method Details

   An object of the form:
 
     { # A store for the merchant. This will be used to match to a store under the Google Business Profile of the target merchant. If a matching store can't be found, the inventories or sales submitted with the store code will not be used.
-  "gcidCategory": [ # Optional. [Google My Business category id](https://gcid-explorer.corp.google.com/static/gcid.html).
+  "gcidCategory": [ # Optional. [Google My Business category id](https://support.google.com/business/answer/7249669).
     "A String",
   ],
   "matchingState": "A String", # Optional. Output only. The state of matching to a Google Business Profile. See matchingStateHint for further details if no match is found.
@@ -217,7 +217,7 @@ 
Method Details

     { # Response message for the ListLfpStores method.
   "lfpStores": [ # The stores from the specified merchant.
     { # A store for the merchant. This will be used to match to a store under the Google Business Profile of the target merchant. If a matching store can't be found, the inventories or sales submitted with the store code will not be used.
-      "gcidCategory": [ # Optional. [Google My Business category id](https://gcid-explorer.corp.google.com/static/gcid.html).
+      "gcidCategory": [ # Optional. [Google My Business category id](https://support.google.com/business/answer/7249669).
         "A String",
       ],
       "matchingState": "A String", # Optional. Output only. The state of matching to a Google Business Profile. See matchingStateHint for further details if no match is found.
diff --git a/docs/dyn/merchantapi_notifications_v1.accounts.html b/docs/dyn/merchantapi_notifications_v1.accounts.html
new file mode 100644
index 00000000000..06b0a9000db
--- /dev/null
+++ b/docs/dyn/merchantapi_notifications_v1.accounts.html
@@ -0,0 +1,91 @@
+
+
+
+
Merchant API . accounts

+
Instance Methods

+

+  notificationsubscriptions()
+

+
Returns the notificationsubscriptions Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_notifications_v1.accounts.notificationsubscriptions.html b/docs/dyn/merchantapi_notifications_v1.accounts.notificationsubscriptions.html
new file mode 100644
index 00000000000..7f28d261c12
--- /dev/null
+++ b/docs/dyn/merchantapi_notifications_v1.accounts.notificationsubscriptions.html
@@ -0,0 +1,258 @@
+
+
+
+
Merchant API . accounts . notificationsubscriptions

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Creates a notification subscription for a business. For standalone or subaccounts accounts, the business can create a subscription for self. For MCAs, the business can create a subscription for all managed accounts or for a specific subaccount. We will allow the following types of notification subscriptions to exist together (per business as a subscriber per event type): 1. Subscription for all managed accounts + subscription for self. 2. Multiple "partial" subscriptions for managed accounts + subscription for self. we will not allow (per business as a subscriber per event type): 1. Multiple self subscriptions. 2. Multiple "all managed accounts" subscriptions. 3. "All managed accounts" subscription and partial subscriptions at the same time. 4. Multiple partial subscriptions for the same target account.

+

+  delete(name, x__xgafv=None)

+
Deletes a notification subscription for a merchant.

+

+  get(name, x__xgafv=None)

+
Gets notification subscriptions for an account.

+

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

+
Gets all the notification subscriptions for a merchant.

+

+  list_next()

+
Retrieves the next page of results.

+

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

+
Updates an existing notification subscription for a merchant.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, x__xgafv=None)
+  
Creates a notification subscription for a business. For standalone or subaccounts accounts, the business can create a subscription for self. For MCAs, the business can create a subscription for all managed accounts or for a specific subaccount. We will allow the following types of notification subscriptions to exist together (per business as a subscriber per event type): 1. Subscription for all managed accounts + subscription for self. 2. Multiple "partial" subscriptions for managed accounts + subscription for self. we will not allow (per business as a subscriber per event type): 1. Multiple self subscriptions. 2. Multiple "all managed accounts" subscriptions. 3. "All managed accounts" subscription and partial subscriptions at the same time. 4. Multiple partial subscriptions for the same target account.
+
+Args:
+  parent: string, Required. The merchant account that owns the new notification subscription. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a notification subscription owned by a Merchant account.
+  "allManagedAccounts": True or False, # If this value is true, the requesting account is notified of the specified event for all managed accounts (can be subaccounts or other linked accounts) including newly added accounts on a daily basis.
+  "callBackUri": "A String", # URL to be used to push the notification to the merchant.
+  "name": "A String", # Output only. The `name` of the notification configuration. Generated by the Content API upon creation of a new `NotificationSubscription`. The `account` represents the merchant ID of the merchant that owns the configuration. Format: `accounts/{account}/notificationsubscriptions/{notification_subscription}`
+  "registeredEvent": "A String", # The event that the merchant wants to be notified about.
+  "targetAccount": "A String", # The `name` of the account you want to receive notifications for. Format: `accounts/{account}`
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a notification subscription owned by a Merchant account.
+  "allManagedAccounts": True or False, # If this value is true, the requesting account is notified of the specified event for all managed accounts (can be subaccounts or other linked accounts) including newly added accounts on a daily basis.
+  "callBackUri": "A String", # URL to be used to push the notification to the merchant.
+  "name": "A String", # Output only. The `name` of the notification configuration. Generated by the Content API upon creation of a new `NotificationSubscription`. The `account` represents the merchant ID of the merchant that owns the configuration. Format: `accounts/{account}/notificationsubscriptions/{notification_subscription}`
+  "registeredEvent": "A String", # The event that the merchant wants to be notified about.
+  "targetAccount": "A String", # The `name` of the account you want to receive notifications for. Format: `accounts/{account}`
+}

+

+
+

+    delete(name, x__xgafv=None)
+  
Deletes a notification subscription for a merchant.
+
+Args:
+  name: string, Required. The name of the notification subscription to be deleted. (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 notification subscriptions for an account.
+
+Args:
+  name: string, Required. The `name` of the notification subscription. (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 notification subscription owned by a Merchant account.
+  "allManagedAccounts": True or False, # If this value is true, the requesting account is notified of the specified event for all managed accounts (can be subaccounts or other linked accounts) including newly added accounts on a daily basis.
+  "callBackUri": "A String", # URL to be used to push the notification to the merchant.
+  "name": "A String", # Output only. The `name` of the notification configuration. Generated by the Content API upon creation of a new `NotificationSubscription`. The `account` represents the merchant ID of the merchant that owns the configuration. Format: `accounts/{account}/notificationsubscriptions/{notification_subscription}`
+  "registeredEvent": "A String", # The event that the merchant wants to be notified about.
+  "targetAccount": "A String", # The `name` of the account you want to receive notifications for. Format: `accounts/{account}`
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Gets all the notification subscriptions for a merchant.
+
+Args:
+  parent: string, Required. The merchant account who owns the notification subscriptions. Format: `accounts/{account}` (required)
+  pageSize: integer, The maximum number of notification subscriptions to return in a page. The default value for `page_size` is 100. The maximum value is `200`. Values above `200` will be coerced to `200`.
+  pageToken: string, Token (if provided) to retrieve the subsequent page. All other parameters must match the original 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 the ListNotificationSubscription method.
+  "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.
+  "notificationSubscriptions": [ # The list of notification subscriptions requested by the merchant.
+    { # Represents a notification subscription owned by a Merchant account.
+      "allManagedAccounts": True or False, # If this value is true, the requesting account is notified of the specified event for all managed accounts (can be subaccounts or other linked accounts) including newly added accounts on a daily basis.
+      "callBackUri": "A String", # URL to be used to push the notification to the merchant.
+      "name": "A String", # Output only. The `name` of the notification configuration. Generated by the Content API upon creation of a new `NotificationSubscription`. The `account` represents the merchant ID of the merchant that owns the configuration. Format: `accounts/{account}/notificationsubscriptions/{notification_subscription}`
+      "registeredEvent": "A String", # The event that the merchant wants to be notified about.
+      "targetAccount": "A String", # The `name` of the account you want to receive notifications for. Format: `accounts/{account}`
+    },
+  ],
+}

+

+
+

+    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 notification subscription for a merchant.
+
+Args:
+  name: string, Output only. The `name` of the notification configuration. Generated by the Content API upon creation of a new `NotificationSubscription`. The `account` represents the merchant ID of the merchant that owns the configuration. Format: `accounts/{account}/notificationsubscriptions/{notification_subscription}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a notification subscription owned by a Merchant account.
+  "allManagedAccounts": True or False, # If this value is true, the requesting account is notified of the specified event for all managed accounts (can be subaccounts or other linked accounts) including newly added accounts on a daily basis.
+  "callBackUri": "A String", # URL to be used to push the notification to the merchant.
+  "name": "A String", # Output only. The `name` of the notification configuration. Generated by the Content API upon creation of a new `NotificationSubscription`. The `account` represents the merchant ID of the merchant that owns the configuration. Format: `accounts/{account}/notificationsubscriptions/{notification_subscription}`
+  "registeredEvent": "A String", # The event that the merchant wants to be notified about.
+  "targetAccount": "A String", # The `name` of the account you want to receive notifications for. Format: `accounts/{account}`
+}
+
+  updateMask: string, List of fields being updated.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a notification subscription owned by a Merchant account.
+  "allManagedAccounts": True or False, # If this value is true, the requesting account is notified of the specified event for all managed accounts (can be subaccounts or other linked accounts) including newly added accounts on a daily basis.
+  "callBackUri": "A String", # URL to be used to push the notification to the merchant.
+  "name": "A String", # Output only. The `name` of the notification configuration. Generated by the Content API upon creation of a new `NotificationSubscription`. The `account` represents the merchant ID of the merchant that owns the configuration. Format: `accounts/{account}/notificationsubscriptions/{notification_subscription}`
+  "registeredEvent": "A String", # The event that the merchant wants to be notified about.
+  "targetAccount": "A String", # The `name` of the account you want to receive notifications for. Format: `accounts/{account}`
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_notifications_v1.html b/docs/dyn/merchantapi_notifications_v1.html
new file mode 100644
index 00000000000..17c598c77d4
--- /dev/null
+++ b/docs/dyn/merchantapi_notifications_v1.html
@@ -0,0 +1,111 @@
+
+
+
+
Merchant API

+
Instance Methods

+

+  accounts()
+

+
Returns the accounts Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  new_batch_http_request()

+
Create a BatchHttpRequest object based on the discovery document.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    new_batch_http_request()
+  
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_ordertracking_v1.accounts.html b/docs/dyn/merchantapi_ordertracking_v1.accounts.html
new file mode 100644
index 00000000000..2fe80ebfe3f
--- /dev/null
+++ b/docs/dyn/merchantapi_ordertracking_v1.accounts.html
@@ -0,0 +1,91 @@
+
+
+
+
Merchant API . accounts

+
Instance Methods

+

+  orderTrackingSignals()
+

+
Returns the orderTrackingSignals Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_ordertracking_v1.accounts.orderTrackingSignals.html b/docs/dyn/merchantapi_ordertracking_v1.accounts.orderTrackingSignals.html
new file mode 100644
index 00000000000..7b2f1b5477a
--- /dev/null
+++ b/docs/dyn/merchantapi_ordertracking_v1.accounts.orderTrackingSignals.html
@@ -0,0 +1,334 @@
+
+
+
+
Merchant API . accounts . orderTrackingSignals

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Creates new order tracking signal.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, orderTrackingSignalId=None, x__xgafv=None)
+  
Creates new order tracking signal.
+
+Args:
+  parent: string, Required. The account of the business for which the order signal is created. Format: accounts/{account} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a business trade from which signals are extracted, such as shipping.
+  "customerShippingFee": { # The price represented as a number and currency. # Optional. The shipping fee of the order; this value should be set to zero in the case of free shipping.
+    "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+    "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+  },
+  "deliveryPostalCode": "A String", # Optional. The delivery postal code, as a continuous string without spaces or dashes, for example "95016". This field will be anonymized in returned OrderTrackingSignal creation response.
+  "deliveryRegionCode": "A String", # Optional. The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) for the shipping destination.
+  "lineItems": [ # Required. Information about line items in the order.
+    { # The line items of the order.
+      "brand": "A String", # Optional. Brand of the product.
+      "gtins": [ # Optional. The Global Trade Item Numbers.
+        "A String",
+      ],
+      "lineItemId": "A String", # Required. The ID for this line item.
+      "mpn": "A String", # Optional. The manufacturer part number.
+      "productId": "A String", # Required. The Content API REST ID of the product, in the form channel:contentLanguage:targetCountry:offerId.
+      "productTitle": "A String", # Optional. Plain text title of this product.
+      "quantity": "A String", # Required. The quantity of the line item in the order.
+    },
+  ],
+  "merchantId": "A String", # Optional. The Google Merchant Center ID of this order tracking signal. This value is optional. If left unset, the caller's Merchant Center ID is used. You must request access in order to provide data on behalf of another business. For more information, see [Submitting Order Tracking Signals](/shopping-content/guides/order-tracking-signals).
+  "orderCreatedTime": { # Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations. # Required. The time when the order was created on the businesses side. Include the year and timezone string, if available.
+    "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.
+    "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+    "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+    "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.
+    "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.
+    "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+    "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Time zone.
+      "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+      "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+    },
+    "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.
+    "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.
+  },
+  "orderId": "A String", # Required. The ID of the order on the businesses side. This field will be hashed in returned OrderTrackingSignal creation response.
+  "orderTrackingSignalId": "A String", # Output only. The ID that uniquely identifies this order tracking signal.
+  "shipmentLineItemMapping": [ # Optional. The mapping of the line items to the shipment information.
+    { # Represents how many items are in the shipment for the given shipment_id and line_item_id.
+      "lineItemId": "A String", # Required. The line item ID.
+      "quantity": "A String", # Required. The line item quantity in the shipment.
+      "shipmentId": "A String", # Required. The shipment ID. This field will be hashed in returned OrderTrackingSignal creation response.
+    },
+  ],
+  "shippingInfo": [ # Required. The shipping information for the order.
+    { # The shipping information for the order.
+      "actualDeliveryTime": { # Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations. # Optional. The time when the shipment was actually delivered. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name.
+        "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.
+        "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+        "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.
+        "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.
+        "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+        "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Time zone.
+          "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+          "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+        },
+        "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.
+        "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.
+      },
+      "carrier": "A String", # Optional. The name of the shipping carrier for the delivery. This field is required if one of the following fields is absent: earliest_delivery_promise_time, latest_delivery_promise_time, and actual_delivery_time.
+      "carrierService": "A String", # Optional. The service type for fulfillment, such as GROUND, FIRST_CLASS, etc.
+      "earliestDeliveryPromiseTime": { # Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations. # Optional. The earliest delivery promised time. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name.
+        "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.
+        "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+        "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.
+        "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.
+        "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+        "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Time zone.
+          "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+          "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+        },
+        "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.
+        "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.
+      },
+      "latestDeliveryPromiseTime": { # Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations. # Optional. The latest delivery promised time. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name.
+        "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.
+        "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+        "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.
+        "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.
+        "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+        "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Time zone.
+          "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+          "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+        },
+        "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.
+        "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.
+      },
+      "originPostalCode": "A String", # Required. The origin postal code, as a continuous string without spaces or dashes, for example "95016". This field will be anonymized in returned OrderTrackingSignal creation response.
+      "originRegionCode": "A String", # Required. The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) for the shipping origin.
+      "shipmentId": "A String", # Required. The shipment ID. This field will be hashed in returned OrderTrackingSignal creation response.
+      "shippedTime": { # Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations. # Optional. The time when the shipment was shipped. Include the year and timezone string, if available.
+        "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.
+        "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+        "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.
+        "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.
+        "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+        "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Time zone.
+          "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+          "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+        },
+        "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.
+        "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.
+      },
+      "shippingStatus": "A String", # Required. The status of the shipment.
+      "trackingId": "A String", # Optional. The tracking ID of the shipment. This field is required if one of the following fields is absent: earliest_delivery_promise_time, latest_delivery_promise_time, and actual_delivery_time.
+    },
+  ],
+}
+
+  orderTrackingSignalId: string, Output only. The ID that uniquely identifies this order tracking signal.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a business trade from which signals are extracted, such as shipping.
+  "customerShippingFee": { # The price represented as a number and currency. # Optional. The shipping fee of the order; this value should be set to zero in the case of free shipping.
+    "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+    "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+  },
+  "deliveryPostalCode": "A String", # Optional. The delivery postal code, as a continuous string without spaces or dashes, for example "95016". This field will be anonymized in returned OrderTrackingSignal creation response.
+  "deliveryRegionCode": "A String", # Optional. The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) for the shipping destination.
+  "lineItems": [ # Required. Information about line items in the order.
+    { # The line items of the order.
+      "brand": "A String", # Optional. Brand of the product.
+      "gtins": [ # Optional. The Global Trade Item Numbers.
+        "A String",
+      ],
+      "lineItemId": "A String", # Required. The ID for this line item.
+      "mpn": "A String", # Optional. The manufacturer part number.
+      "productId": "A String", # Required. The Content API REST ID of the product, in the form channel:contentLanguage:targetCountry:offerId.
+      "productTitle": "A String", # Optional. Plain text title of this product.
+      "quantity": "A String", # Required. The quantity of the line item in the order.
+    },
+  ],
+  "merchantId": "A String", # Optional. The Google Merchant Center ID of this order tracking signal. This value is optional. If left unset, the caller's Merchant Center ID is used. You must request access in order to provide data on behalf of another business. For more information, see [Submitting Order Tracking Signals](/shopping-content/guides/order-tracking-signals).
+  "orderCreatedTime": { # Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations. # Required. The time when the order was created on the businesses side. Include the year and timezone string, if available.
+    "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.
+    "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+    "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+    "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.
+    "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.
+    "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+    "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Time zone.
+      "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+      "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+    },
+    "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.
+    "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.
+  },
+  "orderId": "A String", # Required. The ID of the order on the businesses side. This field will be hashed in returned OrderTrackingSignal creation response.
+  "orderTrackingSignalId": "A String", # Output only. The ID that uniquely identifies this order tracking signal.
+  "shipmentLineItemMapping": [ # Optional. The mapping of the line items to the shipment information.
+    { # Represents how many items are in the shipment for the given shipment_id and line_item_id.
+      "lineItemId": "A String", # Required. The line item ID.
+      "quantity": "A String", # Required. The line item quantity in the shipment.
+      "shipmentId": "A String", # Required. The shipment ID. This field will be hashed in returned OrderTrackingSignal creation response.
+    },
+  ],
+  "shippingInfo": [ # Required. The shipping information for the order.
+    { # The shipping information for the order.
+      "actualDeliveryTime": { # Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations. # Optional. The time when the shipment was actually delivered. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name.
+        "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.
+        "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+        "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.
+        "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.
+        "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+        "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Time zone.
+          "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+          "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+        },
+        "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.
+        "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.
+      },
+      "carrier": "A String", # Optional. The name of the shipping carrier for the delivery. This field is required if one of the following fields is absent: earliest_delivery_promise_time, latest_delivery_promise_time, and actual_delivery_time.
+      "carrierService": "A String", # Optional. The service type for fulfillment, such as GROUND, FIRST_CLASS, etc.
+      "earliestDeliveryPromiseTime": { # Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations. # Optional. The earliest delivery promised time. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name.
+        "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.
+        "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+        "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.
+        "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.
+        "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+        "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Time zone.
+          "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+          "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+        },
+        "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.
+        "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.
+      },
+      "latestDeliveryPromiseTime": { # Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations. # Optional. The latest delivery promised time. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name.
+        "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.
+        "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+        "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.
+        "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.
+        "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+        "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Time zone.
+          "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+          "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+        },
+        "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.
+        "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.
+      },
+      "originPostalCode": "A String", # Required. The origin postal code, as a continuous string without spaces or dashes, for example "95016". This field will be anonymized in returned OrderTrackingSignal creation response.
+      "originRegionCode": "A String", # Required. The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) for the shipping origin.
+      "shipmentId": "A String", # Required. The shipment ID. This field will be hashed in returned OrderTrackingSignal creation response.
+      "shippedTime": { # Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations. # Optional. The time when the shipment was shipped. Include the year and timezone string, if available.
+        "day": 42, # Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.
+        "hours": 42, # Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value "24:00:00" for scenarios like business closing time.
+        "minutes": 42, # Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.
+        "month": 42, # Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.
+        "nanos": 42, # Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.
+        "seconds": 42, # Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.
+        "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Time zone.
+          "id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
+          "version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
+        },
+        "utcOffset": "A String", # UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.
+        "year": 42, # Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.
+      },
+      "shippingStatus": "A String", # Required. The status of the shipment.
+      "trackingId": "A String", # Optional. The tracking ID of the shipment. This field is required if one of the following fields is absent: earliest_delivery_promise_time, latest_delivery_promise_time, and actual_delivery_time.
+    },
+  ],
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_ordertracking_v1.html b/docs/dyn/merchantapi_ordertracking_v1.html
new file mode 100644
index 00000000000..3fc92ebb6d6
--- /dev/null
+++ b/docs/dyn/merchantapi_ordertracking_v1.html
@@ -0,0 +1,111 @@
+
+
+
+
Merchant API

+
Instance Methods

+

+  accounts()
+

+
Returns the accounts Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  new_batch_http_request()

+
Create a BatchHttpRequest object based on the discovery document.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    new_batch_http_request()
+  
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_ordertracking_v1beta.accounts.orderTrackingSignals.html b/docs/dyn/merchantapi_ordertracking_v1beta.accounts.orderTrackingSignals.html
index 6270dc4db15..bc4419e6678 100644
--- a/docs/dyn/merchantapi_ordertracking_v1beta.accounts.orderTrackingSignals.html
+++ b/docs/dyn/merchantapi_ordertracking_v1beta.accounts.orderTrackingSignals.html
@@ -106,6 +106,9 @@ 
Method Details

     { # The line items of the order.
       "brand": "A String", # Optional. Brand of the product.
       "gtin": "A String", # Optional. The Global Trade Item Number.
+      "gtins": [ # Optional. The Global Trade Item Numbers.
+        "A String",
+      ],
       "lineItemId": "A String", # Required. The ID for this line item.
       "mpn": "A String", # Optional. The manufacturer part number.
       "productId": "A String", # Required. The Content API REST ID of the product, in the form channel:contentLanguage:targetCountry:offerId.
@@ -226,6 +229,9 @@ 
Method Details

     { # The line items of the order.
       "brand": "A String", # Optional. Brand of the product.
       "gtin": "A String", # Optional. The Global Trade Item Number.
+      "gtins": [ # Optional. The Global Trade Item Numbers.
+        "A String",
+      ],
       "lineItemId": "A String", # Required. The ID for this line item.
       "mpn": "A String", # Optional. The manufacturer part number.
       "productId": "A String", # Required. The Content API REST ID of the product, in the form channel:contentLanguage:targetCountry:offerId.
diff --git a/docs/dyn/merchantapi_products_v1.accounts.html b/docs/dyn/merchantapi_products_v1.accounts.html
new file mode 100644
index 00000000000..890b294fa9a
--- /dev/null
+++ b/docs/dyn/merchantapi_products_v1.accounts.html
@@ -0,0 +1,96 @@
+
+
+
+
Merchant API . accounts

+
Instance Methods

+

+  productInputs()
+

+
Returns the productInputs Resource.

+
+

+  products()
+

+
Returns the products Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_products_v1.accounts.productInputs.html b/docs/dyn/merchantapi_products_v1.accounts.productInputs.html
new file mode 100644
index 00000000000..0e74e982679
--- /dev/null
+++ b/docs/dyn/merchantapi_products_v1.accounts.productInputs.html
@@ -0,0 +1,1337 @@
+
+
+
+
Merchant API . accounts . productInputs

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  delete(name, dataSource=None, x__xgafv=None)

+
Deletes a product input from your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.

+

+  insert(parent, body=None, dataSource=None, x__xgafv=None)

+
[Uploads a product input to your Merchant Center account](/merchant/api/guides/products/overview#upload-product-input). You must have a products [data source](/merchant/api/guides/data-sources/overview) to be able to insert a product. The unique identifier of the data source is passed as a query parameter in the request URL. If a product input with the same contentLanguage, offerId, and dataSource already exists, then the product input inserted by this method replaces that entry. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.

+

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

+
Updates the existing product input in your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    delete(name, dataSource=None, x__xgafv=None)
+  
Deletes a product input from your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.
+
+Args:
+  name: string, Required. The name of the product input resource to delete. Format: `accounts/{account}/productInputs/{product}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/productInputs/en~US~sku123`. (required)
+  dataSource: string, Required. The primary or supplemental data source from which the product input should be deleted. Format: `accounts/{account}/dataSources/{datasource}`. For example, `accounts/123456/dataSources/104628`.
+  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); }
+}

+

+
+

+    insert(parent, body=None, dataSource=None, x__xgafv=None)
+  
[Uploads a product input to your Merchant Center account](/merchant/api/guides/products/overview#upload-product-input). You must have a products [data source](/merchant/api/guides/data-sources/overview) to be able to insert a product. The unique identifier of the data source is passed as a query parameter in the request URL. If a product input with the same contentLanguage, offerId, and dataSource already exists, then the product input inserted by this method replaces that entry. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.
+
+Args:
+  parent: string, Required. The account where this product will be inserted. Format: `accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # This resource represents input data you submit for a product, not the processed product that you see in Merchant Center, in Shopping ads, or across Google surfaces. Product inputs, rules and supplemental data source data are combined to create the processed Product. For more information, see [Manage products](/merchant/api/guides/products/overview). Required product input attributes to pass data validation checks are primarily defined in the [Products Data Specification](https://support.google.com/merchants/answer/188494). The following attributes are required: feedLabel, contentLanguage and offerId. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved. All fields in the product input and its sub-messages match the English name of their corresponding attribute in the [Products Data Specification](https://support.google.com/merchants/answer/188494) with [some exceptions](https://support.google.com/merchants/answer/7052112). The following reference documentation lists the field names in the **camelCase** casing style while the Products Data Specification lists the names in the **snake_case** casing style.
+  "contentLanguage": "A String", # Required. Immutable. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the product.
+  "customAttributes": [ # Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" }`). This is useful for submitting attributes not explicitly exposed by the API. Maximum allowed number of characters for each custom attribute is 10240 (represents sum of characters for name and value). Maximum 2500 custom attributes can be set per product, with total size of 102.4kB. Underscores in custom attribute names are replaced by spaces upon insertion.
+    { # A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.
+      "groupValues": [ # Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.
+        # Object with schema name: CustomAttribute
+      ],
+      "name": "A String", # The name of the attribute.
+      "value": "A String", # The value of the attribute. If `value` is not empty, `group_values` must be empty.
+    },
+  ],
+  "feedLabel": "A String", # Required. Immutable. The feed label that lets you categorize and identify your products. The maximum allowed characters are 20, and the supported characters are `A-Z`, `0-9`, hyphen, and underscore. The feed label must not include any spaces. For more information, see [Using feed labels](//support.google.com/merchants/answer/14994087).
+  "legacyLocal": True or False, # Immutable. Determines whether the product is **only** targeting local destinations and whether the product name should be distinguished with a `local~` prefix. For example, `accounts/123/productInputs/local~en~US~sku123`. If a product that is not `legacy_local` is already targeting local destinations, creating a `legacy_local` product with an otherwise matching name will fail.
+  "name": "A String", # Identifier. The name of the product input. Format: `accounts/{account}/productInputs/{productinput}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.
+  "offerId": "A String", # Required. Immutable. Your unique identifier for the product. This is the same for the product input and processed product. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. See the [products data specification](https://support.google.com/merchants/answer/188494#id) for details.
+  "product": "A String", # Output only. The name of the processed product. Format: `accounts/{account}/products/{product}`
+  "productAttributes": { # Product attributes. # Optional. A list of strongly-typed product attributes.
+    "additionalImageLinks": [ # Additional URLs of images of the item.
+      "A String",
+    ],
+    "adsGrouping": "A String", # Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
+    "adsLabels": [ # Similar to ads_grouping, but only works on CPC.
+      "A String",
+    ],
+    "adsRedirect": "A String", # Allows advertisers to override the item URL when the product is shown within the context of Product ads.
+    "adult": True or False, # Set to true if the item is targeted towards adults.
+    "ageGroup": "A String", # Target [age group](https://support.google.com/merchants/answer/6324463) of the item.
+    "autoPricingMinPrice": { # The price represented as a number and currency. # A safeguard in the [automated discounts] (https://support.google.com/merchants/answer/10295759) and "Dynamic Promotions" (https://support.google.com/merchants/answer/13949249) projects, ensuring that discounts on business offers do not fall below this value, thereby preserving the offer's value and profitability.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "availability": "A String", # [Availability](https://support.google.com/merchants/answer/6324448) status of the item.
+    "availabilityDate": "A String", # The day a pre-ordered product becomes available for delivery, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+    "brand": "A String", # [Brand](https://support.google.com/merchants/answer/6324351) of the item. For example, "Google".
+    "canonicalLink": "A String", # URL for the canonical version of your item's landing page.
+    "certifications": [ # Product Certifications, for example for energy efficiency labeling of products recorded in the [EU EPREL](https://eprel.ec.europa.eu/screen/home) database. See the [Help Center](https://support.google.com/merchants/answer/13528839) article for more information.
+      { # Product [certification](https://support.google.com/merchants/answer/13528839), initially introduced for EU energy efficiency labeling compliance using the EU EPREL database.
+        "certificationAuthority": "A String", # The certification authority.
+        "certificationCode": "A String", # The certification code. Maximum length is 2000 characters.
+        "certificationName": "A String", # The name of the certification.
+        "certificationValue": "A String", # The certification value (also known as class, level or grade), for example "A+", "C", "gold". Maximum length is 2000 characters.
+      },
+    ],
+    "cloudExportAdditionalProperties": [ # Extra fields to export to the Cloud Retail program.
+      { # Product property for the Cloud Retail API. For example, properties for a TV product could be "Screen-Resolution" or "Screen-Size".
+        "boolValue": True or False, # Boolean value of the given property. For example for a TV product, "True" or "False" if the screen is UHD.
+        "floatValue": [ # Float values of the given property. For example for a TV product 1.2345. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+          3.14,
+        ],
+        "intValue": [ # Integer values of the given property. For example, 1080 for a TV product's Screen Resolution. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+          "A String",
+        ],
+        "maxValue": 3.14, # Maximum float value of the given property. For example for a TV product 100.00.
+        "minValue": 3.14, # Minimum float value of the given property. For example for a TV product 1.00.
+        "propertyName": "A String", # Name of the given property. For example, "Screen-Resolution" for a TV product. Maximum string size is 256 characters.
+        "textValue": [ # Text value of the given property. For example, "8K(UHD)" could be a text value for a TV product. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order. Maximum string size is 256 characters.
+          "A String",
+        ],
+        "unitCode": "A String", # Unit of the given property. For example, "Pixels" for a TV product. Maximum string size is 256B.
+      },
+    ],
+    "color": "A String", # [Color](https://support.google.com/merchants/answer/6324487) of the item. For example, "red".
+    "condition": "A String", # [Condition](https://support.google.com/merchants/answer/6324469) or state of the item.
+    "costOfGoodsSold": { # The price represented as a number and currency. # Cost of goods sold. Used for gross profit reporting.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "customLabel0": "A String", # [Custom label 0](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel1": "A String", # [Custom label 1](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel2": "A String", # [Custom label 2](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel3": "A String", # [Custom label 3](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel4": "A String", # [Custom label 4](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "description": "A String", # Description of the item.
+    "disclosureDate": "A String", # The date time when an offer becomes visible in search results across Google’s YouTube surfaces, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. See [Disclosure date](https://support.google.com/merchants/answer/13034208) for more information.
+    "displayAdsId": "A String", # An identifier for an item for dynamic remarketing campaigns.
+    "displayAdsLink": "A String", # URL directly to your item's landing page for dynamic remarketing campaigns.
+    "displayAdsSimilarIds": [ # Advertiser-specified recommendations. For more information, see [Display ads attribute specification](https://support.google.com/merchants/answer/6069387).
+      "A String",
+    ],
+    "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](https://support.google.com/merchants/answer/7562785) 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.
+      "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.
+    "externalSellerId": "A String", # Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account.
+    "freeShippingThreshold": [ # Conditions to be met for a product to have free shipping.
+      { # Conditions to be met for a product to have free shipping.
+        "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+        "priceThreshold": { # The price represented as a number and currency. # The minimum product price for the shipping cost to become free. Represented as a number.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+      },
+    ],
+    "gender": "A String", # Target [gender](https://support.google.com/merchants/answer/6324479) of the item.
+    "googleProductCategory": "A String", # Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
+    "gtins": [ # Global Trade Item Numbers ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item. You can provide up to 10 GTINs.
+      "A String",
+    ],
+    "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.
+      "A String",
+    ],
+    "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per month.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "creditType": "A String", # Type of installment payments.
+      "downpayment": { # The price represented as a number and currency. # The up-front down payment amount the buyer has to pay.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "months": "A String", # The number of installments the buyer has to pay.
+    },
+    "isBundle": True or False, # Whether the item is a business-defined sub-API. A [sub-API] (https://support.google.com/merchants/answer/6324449) is a custom grouping of different products sold by a business for a single price.
+    "itemGroupId": "A String", # Shared identifier for all variants of the same product.
+    "lifestyleImageLinks": [ # Additional URLs of lifestyle images of the item, used to explicitly identify images that showcase your item in a real-world context. See the [Help Center article](https://support.google.com/merchants/answer/9103186) for more information.
+      "A String",
+    ],
+    "link": "A String", # URL directly linking to your item's page on your online store.
+    "linkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13871172) for business hosted local storefront.
+    "loyaltyPoints": { # A message that represents loyalty points. # Loyalty points that users receive after purchasing the item. Japan only.
+      "name": "A String", # Name of loyalty points program. It is recommended to limit the name to 12 full-width characters or 24 Roman characters.
+      "pointsValue": "A String", # The retailer's loyalty points in absolute value.
+      "ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.
+    },
+    "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item.
+      { # A message that represents loyalty program.
+        "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "loyaltyPoints": "A String", # The amount of loyalty points earned on a purchase.
+        "memberPriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # A date range during which the item is eligible for member price. If not specified, the member price is always applicable. The date range is represented by a pair of ISO 8601 dates separated by a space, comma, or slash.
+          "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+          "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+        },
+        "price": { # The price represented as a number and currency. # The price for members of the given tier, that is, the instant discount price. Must be smaller or equal to the regular price.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "programLabel": "A String", # The label of the loyalty program. This is an internal label that uniquely identifies the relationship between a business entity and a loyalty program entity. The label must be provided so that the system can associate the assets below (for example, price and points) with a business. The corresponding program must be linked to the Merchant Center account.
+        "shippingLabel": "A String", # The label of the shipping benefit. If the field has value, this offer has loyalty shipping benefit. If the field value isn't provided, the item is not eligible for loyalty shipping for the given loyalty tier.
+        "tierLabel": "A String", # The label of the tier within the loyalty program. Must match one of the labels within the program.
+      },
+    ],
+    "material": "A String", # The [material](https://support.google.com/merchants/answer/6324410) of which the item is made. For example, "Leather" or "Cotton".
+    "maxEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+    "maxHandlingTime": "A String", # Maximal product handling time (in business days).
+    "maximumRetailPrice": { # The price represented as a number and currency. # Maximum retail price (MRP) of the item. Applicable to India only.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "minEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+    "minHandlingTime": "A String", # Minimal product handling time (in business days).
+    "mobileLink": "A String", # URL for the mobile-optimized version of your item's landing page.
+    "mobileLinkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13870216) for business hosted local storefront optimized for mobile devices.
+    "mpn": "A String", # Manufacturer Part Number ([MPN](https://support.google.com/merchants/answer/188494#mpn)) of the item.
+    "multipack": "A String", # The number of identical products in a business-defined multipack.
+    "pattern": "A String", # The item's [pattern](https://support.google.com/merchants/answer/6324483). For example, polka dots.
+    "pause": "A String", # Publication of this item will be temporarily [paused](https://support.google.com/merchants/answer/11909930).
+    "pickupMethod": "A String", # The [pickup](https://support.google.com/merchants/answer/14634021) option for the item.
+    "pickupSla": "A String", # Item store pickup timeline. For more information, see [Pickup SLA](https://support.google.com/merchants/answer/14635400).
+    "price": { # The price represented as a number and currency. # Price of the item.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "productDetails": [ # Technical specification or additional product details.
+      { # The product details.
+        "attributeName": "A String", # The name of the product detail.
+        "attributeValue": "A String", # The value of the product detail.
+        "sectionName": "A String", # The section header used to group a set of product details.
+      },
+    ],
+    "productHeight": { # The dimension of the product. # The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "productHighlights": [ # Bullet points describing the most relevant [product highlights](https://support.google.com/merchants/answer/9216100).
+      "A String",
+    ],
+    "productLength": { # The dimension of the product. # The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "productTypes": [ # Categories of the item (formatted as in [product data specification](https://support.google.com/merchants/answer/7052112#product_category)).
+      "A String",
+    ],
+    "productWeight": { # The weight of the product. # The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).
+      "unit": "A String", # Required. The weight unit. Acceptable values are: * "`g`" * "`kg`" * "`oz`" * "`lb`"
+      "value": 3.14, # Required. The weight represented as a number. The weight can have a maximum precision of four decimal places.
+    },
+    "productWidth": { # The dimension of the product. # The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "promotionIds": [ # The unique ID of a promotion.
+      "A String",
+    ],
+    "salePrice": { # The price represented as a number and currency. # Advertised sale price of the item.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Date range during which the item is on sale, see [product data specification](https://support.google.com/merchants/answer/7052112#price_and_availability).
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+    "sellOnGoogleQuantity": "A String", # The quantity of the product that is available for selling on Google. Supported only for online products.
+    "shipping": [ # Shipping rules.
+      { # The Shipping of the product.
+        "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+        "locationGroupName": "A String", # The location where the shipping is applicable, represented by a location group name.
+        "locationId": "A String", # The numeric ID of a location that the shipping rate applies to as defined in the [AdWords API](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
+        "maxHandlingTime": "A String", # Maximum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minHandlingTime is optional if maxHandlingTime is present.
+        "maxTransitTime": "A String", # Maximum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minTransitTime is optional if maxTransitTime is present.
+        "minHandlingTime": "A String", # Minimum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. minHandlingTime can only be present together with maxHandlingTime; but it is not required if maxHandlingTime is present.
+        "minTransitTime": "A String", # Minimum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. minTransitTime can only be present together with maxTransitTime; but it is not required if maxTransitTime is present.
+        "postalCode": "A String", # The postal code range that the shipping rate applies to, represented by a postal code, a postal code prefix followed by a * wildcard, a range between two postal codes or two postal code prefixes of equal length.
+        "price": { # The price represented as a number and currency. # Fixed shipping price, represented as a number.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "region": "A String", # The geographic region to which a shipping rate applies. See [region](https://support.google.com/merchants/answer/6324484) for more information.
+        "service": "A String", # A free-form description of the service class or delivery speed.
+      },
+    ],
+    "shippingHeight": { # The ShippingDimension of the product. # Height of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shippingLabel": "A String", # The shipping label of the product, used to group product in account-level shipping rules.
+    "shippingLength": { # The ShippingDimension of the product. # Length of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shippingWeight": { # The ShippingWeight of the product. # Weight of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The weight of the product used to calculate the shipping cost of the item.
+    },
+    "shippingWidth": { # The ShippingDimension of the product. # Width of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shoppingAdsExcludedCountries": [ # List of country codes [(ISO 3166-1 alpha-2)](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in data source settings.
+      "A String",
+    ],
+    "size": "A String", # Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same `itemGroupId` value, see [Size](https://support.google.com/merchants/answer/6324492).
+    "sizeSystem": "A String", # System in which the size is specified. Recommended for apparel items. For more information, see [Size system](https://support.google.com/merchants/answer/6324502).
+    "sizeTypes": [ # The cut of the item. It can be used to represent combined size types for apparel items. Maximum two of size types can be provided, see [Size type](https://support.google.com/merchants/answer/6324497).
+      "A String",
+    ],
+    "structuredDescription": { # Structured description, for algorithmically (AI)-generated descriptions. # Structured description, for algorithmically (AI)-generated descriptions.
+      "content": "A String", # The description text Maximum length is 5000 characters
+      "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+    },
+    "structuredTitle": { # Structured title, for algorithmically (AI)-generated titles. # Structured title, for algorithmically (AI)-generated titles.
+      "content": "A String", # The title text Maximum length is 150 characters
+      "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+    },
+    "subscriptionCost": { # The SubscriptionCost of the product. # Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per subscription period.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "period": "A String", # The type of subscription period. Supported values are: * "`month`" * "`year`"
+      "periodLength": "A String", # The number of subscription periods the buyer has to pay.
+    },
+    "sustainabilityIncentives": [ # The list of sustainability incentive programs.
+      { # Information regarding sustainability-related incentive programs such as rebates or tax relief.
+        "amount": { # The price represented as a number and currency. # The fixed amount of the incentive.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "percentage": 3.14, # The percentage of the sale price that the incentive is applied to.
+        "type": "A String", # Sustainability incentive program.
+      },
+    ],
+    "title": "A String", # Title of the item.
+    "transitTimeLabel": "A String", # The transit time label of the product, used to group product in account-level transit time tables.
+    "unitPricingBaseMeasure": { # The UnitPricingBaseMeasure of the product. # The preference of the denominator of the unit price.
+      "unit": "A String", # The unit of the denominator.
+      "value": "A String", # The denominator of the unit price.
+    },
+    "unitPricingMeasure": { # The UnitPricingMeasure of the product. # The measure and dimension of an item.
+      "unit": "A String", # The unit of the measure.
+      "value": 3.14, # The measure of an item.
+    },
+    "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information.
+  },
+  "versionNumber": "A String", # Optional. Immutable. Represents the existing version (freshness) of the product, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing product. Re-insertion (for example, product refresh after 30 days) can be performed with the current `version_number`. Only supported for insertions into primary data sources. Do not set this field for updates. Do not set this field for insertions into supplemental data sources. If the operation is prevented, the aborted exception will be thrown.
+}
+
+  dataSource: string, Required. The primary or supplemental product data source name. If the product already exists and data source provided is different, then the product will be moved to a new data source. For more information, see [Overview of Data sources sub-API](/merchant/api/guides/data-sources/overview). Only API data sources are supported. Format: `accounts/{account}/dataSources/{datasource}`. For example, `accounts/123456/dataSources/104628`.
+  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 input data you submit for a product, not the processed product that you see in Merchant Center, in Shopping ads, or across Google surfaces. Product inputs, rules and supplemental data source data are combined to create the processed Product. For more information, see [Manage products](/merchant/api/guides/products/overview). Required product input attributes to pass data validation checks are primarily defined in the [Products Data Specification](https://support.google.com/merchants/answer/188494). The following attributes are required: feedLabel, contentLanguage and offerId. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved. All fields in the product input and its sub-messages match the English name of their corresponding attribute in the [Products Data Specification](https://support.google.com/merchants/answer/188494) with [some exceptions](https://support.google.com/merchants/answer/7052112). The following reference documentation lists the field names in the **camelCase** casing style while the Products Data Specification lists the names in the **snake_case** casing style.
+  "contentLanguage": "A String", # Required. Immutable. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the product.
+  "customAttributes": [ # Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" }`). This is useful for submitting attributes not explicitly exposed by the API. Maximum allowed number of characters for each custom attribute is 10240 (represents sum of characters for name and value). Maximum 2500 custom attributes can be set per product, with total size of 102.4kB. Underscores in custom attribute names are replaced by spaces upon insertion.
+    { # A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.
+      "groupValues": [ # Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.
+        # Object with schema name: CustomAttribute
+      ],
+      "name": "A String", # The name of the attribute.
+      "value": "A String", # The value of the attribute. If `value` is not empty, `group_values` must be empty.
+    },
+  ],
+  "feedLabel": "A String", # Required. Immutable. The feed label that lets you categorize and identify your products. The maximum allowed characters are 20, and the supported characters are `A-Z`, `0-9`, hyphen, and underscore. The feed label must not include any spaces. For more information, see [Using feed labels](//support.google.com/merchants/answer/14994087).
+  "legacyLocal": True or False, # Immutable. Determines whether the product is **only** targeting local destinations and whether the product name should be distinguished with a `local~` prefix. For example, `accounts/123/productInputs/local~en~US~sku123`. If a product that is not `legacy_local` is already targeting local destinations, creating a `legacy_local` product with an otherwise matching name will fail.
+  "name": "A String", # Identifier. The name of the product input. Format: `accounts/{account}/productInputs/{productinput}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.
+  "offerId": "A String", # Required. Immutable. Your unique identifier for the product. This is the same for the product input and processed product. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. See the [products data specification](https://support.google.com/merchants/answer/188494#id) for details.
+  "product": "A String", # Output only. The name of the processed product. Format: `accounts/{account}/products/{product}`
+  "productAttributes": { # Product attributes. # Optional. A list of strongly-typed product attributes.
+    "additionalImageLinks": [ # Additional URLs of images of the item.
+      "A String",
+    ],
+    "adsGrouping": "A String", # Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
+    "adsLabels": [ # Similar to ads_grouping, but only works on CPC.
+      "A String",
+    ],
+    "adsRedirect": "A String", # Allows advertisers to override the item URL when the product is shown within the context of Product ads.
+    "adult": True or False, # Set to true if the item is targeted towards adults.
+    "ageGroup": "A String", # Target [age group](https://support.google.com/merchants/answer/6324463) of the item.
+    "autoPricingMinPrice": { # The price represented as a number and currency. # A safeguard in the [automated discounts] (https://support.google.com/merchants/answer/10295759) and "Dynamic Promotions" (https://support.google.com/merchants/answer/13949249) projects, ensuring that discounts on business offers do not fall below this value, thereby preserving the offer's value and profitability.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "availability": "A String", # [Availability](https://support.google.com/merchants/answer/6324448) status of the item.
+    "availabilityDate": "A String", # The day a pre-ordered product becomes available for delivery, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+    "brand": "A String", # [Brand](https://support.google.com/merchants/answer/6324351) of the item. For example, "Google".
+    "canonicalLink": "A String", # URL for the canonical version of your item's landing page.
+    "certifications": [ # Product Certifications, for example for energy efficiency labeling of products recorded in the [EU EPREL](https://eprel.ec.europa.eu/screen/home) database. See the [Help Center](https://support.google.com/merchants/answer/13528839) article for more information.
+      { # Product [certification](https://support.google.com/merchants/answer/13528839), initially introduced for EU energy efficiency labeling compliance using the EU EPREL database.
+        "certificationAuthority": "A String", # The certification authority.
+        "certificationCode": "A String", # The certification code. Maximum length is 2000 characters.
+        "certificationName": "A String", # The name of the certification.
+        "certificationValue": "A String", # The certification value (also known as class, level or grade), for example "A+", "C", "gold". Maximum length is 2000 characters.
+      },
+    ],
+    "cloudExportAdditionalProperties": [ # Extra fields to export to the Cloud Retail program.
+      { # Product property for the Cloud Retail API. For example, properties for a TV product could be "Screen-Resolution" or "Screen-Size".
+        "boolValue": True or False, # Boolean value of the given property. For example for a TV product, "True" or "False" if the screen is UHD.
+        "floatValue": [ # Float values of the given property. For example for a TV product 1.2345. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+          3.14,
+        ],
+        "intValue": [ # Integer values of the given property. For example, 1080 for a TV product's Screen Resolution. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+          "A String",
+        ],
+        "maxValue": 3.14, # Maximum float value of the given property. For example for a TV product 100.00.
+        "minValue": 3.14, # Minimum float value of the given property. For example for a TV product 1.00.
+        "propertyName": "A String", # Name of the given property. For example, "Screen-Resolution" for a TV product. Maximum string size is 256 characters.
+        "textValue": [ # Text value of the given property. For example, "8K(UHD)" could be a text value for a TV product. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order. Maximum string size is 256 characters.
+          "A String",
+        ],
+        "unitCode": "A String", # Unit of the given property. For example, "Pixels" for a TV product. Maximum string size is 256B.
+      },
+    ],
+    "color": "A String", # [Color](https://support.google.com/merchants/answer/6324487) of the item. For example, "red".
+    "condition": "A String", # [Condition](https://support.google.com/merchants/answer/6324469) or state of the item.
+    "costOfGoodsSold": { # The price represented as a number and currency. # Cost of goods sold. Used for gross profit reporting.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "customLabel0": "A String", # [Custom label 0](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel1": "A String", # [Custom label 1](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel2": "A String", # [Custom label 2](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel3": "A String", # [Custom label 3](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel4": "A String", # [Custom label 4](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "description": "A String", # Description of the item.
+    "disclosureDate": "A String", # The date time when an offer becomes visible in search results across Google’s YouTube surfaces, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. See [Disclosure date](https://support.google.com/merchants/answer/13034208) for more information.
+    "displayAdsId": "A String", # An identifier for an item for dynamic remarketing campaigns.
+    "displayAdsLink": "A String", # URL directly to your item's landing page for dynamic remarketing campaigns.
+    "displayAdsSimilarIds": [ # Advertiser-specified recommendations. For more information, see [Display ads attribute specification](https://support.google.com/merchants/answer/6069387).
+      "A String",
+    ],
+    "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](https://support.google.com/merchants/answer/7562785) 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.
+      "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.
+    "externalSellerId": "A String", # Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account.
+    "freeShippingThreshold": [ # Conditions to be met for a product to have free shipping.
+      { # Conditions to be met for a product to have free shipping.
+        "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+        "priceThreshold": { # The price represented as a number and currency. # The minimum product price for the shipping cost to become free. Represented as a number.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+      },
+    ],
+    "gender": "A String", # Target [gender](https://support.google.com/merchants/answer/6324479) of the item.
+    "googleProductCategory": "A String", # Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
+    "gtins": [ # Global Trade Item Numbers ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item. You can provide up to 10 GTINs.
+      "A String",
+    ],
+    "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.
+      "A String",
+    ],
+    "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per month.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "creditType": "A String", # Type of installment payments.
+      "downpayment": { # The price represented as a number and currency. # The up-front down payment amount the buyer has to pay.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "months": "A String", # The number of installments the buyer has to pay.
+    },
+    "isBundle": True or False, # Whether the item is a business-defined sub-API. A [sub-API] (https://support.google.com/merchants/answer/6324449) is a custom grouping of different products sold by a business for a single price.
+    "itemGroupId": "A String", # Shared identifier for all variants of the same product.
+    "lifestyleImageLinks": [ # Additional URLs of lifestyle images of the item, used to explicitly identify images that showcase your item in a real-world context. See the [Help Center article](https://support.google.com/merchants/answer/9103186) for more information.
+      "A String",
+    ],
+    "link": "A String", # URL directly linking to your item's page on your online store.
+    "linkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13871172) for business hosted local storefront.
+    "loyaltyPoints": { # A message that represents loyalty points. # Loyalty points that users receive after purchasing the item. Japan only.
+      "name": "A String", # Name of loyalty points program. It is recommended to limit the name to 12 full-width characters or 24 Roman characters.
+      "pointsValue": "A String", # The retailer's loyalty points in absolute value.
+      "ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.
+    },
+    "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item.
+      { # A message that represents loyalty program.
+        "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "loyaltyPoints": "A String", # The amount of loyalty points earned on a purchase.
+        "memberPriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # A date range during which the item is eligible for member price. If not specified, the member price is always applicable. The date range is represented by a pair of ISO 8601 dates separated by a space, comma, or slash.
+          "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+          "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+        },
+        "price": { # The price represented as a number and currency. # The price for members of the given tier, that is, the instant discount price. Must be smaller or equal to the regular price.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "programLabel": "A String", # The label of the loyalty program. This is an internal label that uniquely identifies the relationship between a business entity and a loyalty program entity. The label must be provided so that the system can associate the assets below (for example, price and points) with a business. The corresponding program must be linked to the Merchant Center account.
+        "shippingLabel": "A String", # The label of the shipping benefit. If the field has value, this offer has loyalty shipping benefit. If the field value isn't provided, the item is not eligible for loyalty shipping for the given loyalty tier.
+        "tierLabel": "A String", # The label of the tier within the loyalty program. Must match one of the labels within the program.
+      },
+    ],
+    "material": "A String", # The [material](https://support.google.com/merchants/answer/6324410) of which the item is made. For example, "Leather" or "Cotton".
+    "maxEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+    "maxHandlingTime": "A String", # Maximal product handling time (in business days).
+    "maximumRetailPrice": { # The price represented as a number and currency. # Maximum retail price (MRP) of the item. Applicable to India only.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "minEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+    "minHandlingTime": "A String", # Minimal product handling time (in business days).
+    "mobileLink": "A String", # URL for the mobile-optimized version of your item's landing page.
+    "mobileLinkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13870216) for business hosted local storefront optimized for mobile devices.
+    "mpn": "A String", # Manufacturer Part Number ([MPN](https://support.google.com/merchants/answer/188494#mpn)) of the item.
+    "multipack": "A String", # The number of identical products in a business-defined multipack.
+    "pattern": "A String", # The item's [pattern](https://support.google.com/merchants/answer/6324483). For example, polka dots.
+    "pause": "A String", # Publication of this item will be temporarily [paused](https://support.google.com/merchants/answer/11909930).
+    "pickupMethod": "A String", # The [pickup](https://support.google.com/merchants/answer/14634021) option for the item.
+    "pickupSla": "A String", # Item store pickup timeline. For more information, see [Pickup SLA](https://support.google.com/merchants/answer/14635400).
+    "price": { # The price represented as a number and currency. # Price of the item.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "productDetails": [ # Technical specification or additional product details.
+      { # The product details.
+        "attributeName": "A String", # The name of the product detail.
+        "attributeValue": "A String", # The value of the product detail.
+        "sectionName": "A String", # The section header used to group a set of product details.
+      },
+    ],
+    "productHeight": { # The dimension of the product. # The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "productHighlights": [ # Bullet points describing the most relevant [product highlights](https://support.google.com/merchants/answer/9216100).
+      "A String",
+    ],
+    "productLength": { # The dimension of the product. # The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "productTypes": [ # Categories of the item (formatted as in [product data specification](https://support.google.com/merchants/answer/7052112#product_category)).
+      "A String",
+    ],
+    "productWeight": { # The weight of the product. # The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).
+      "unit": "A String", # Required. The weight unit. Acceptable values are: * "`g`" * "`kg`" * "`oz`" * "`lb`"
+      "value": 3.14, # Required. The weight represented as a number. The weight can have a maximum precision of four decimal places.
+    },
+    "productWidth": { # The dimension of the product. # The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "promotionIds": [ # The unique ID of a promotion.
+      "A String",
+    ],
+    "salePrice": { # The price represented as a number and currency. # Advertised sale price of the item.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Date range during which the item is on sale, see [product data specification](https://support.google.com/merchants/answer/7052112#price_and_availability).
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+    "sellOnGoogleQuantity": "A String", # The quantity of the product that is available for selling on Google. Supported only for online products.
+    "shipping": [ # Shipping rules.
+      { # The Shipping of the product.
+        "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+        "locationGroupName": "A String", # The location where the shipping is applicable, represented by a location group name.
+        "locationId": "A String", # The numeric ID of a location that the shipping rate applies to as defined in the [AdWords API](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
+        "maxHandlingTime": "A String", # Maximum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minHandlingTime is optional if maxHandlingTime is present.
+        "maxTransitTime": "A String", # Maximum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minTransitTime is optional if maxTransitTime is present.
+        "minHandlingTime": "A String", # Minimum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. minHandlingTime can only be present together with maxHandlingTime; but it is not required if maxHandlingTime is present.
+        "minTransitTime": "A String", # Minimum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. minTransitTime can only be present together with maxTransitTime; but it is not required if maxTransitTime is present.
+        "postalCode": "A String", # The postal code range that the shipping rate applies to, represented by a postal code, a postal code prefix followed by a * wildcard, a range between two postal codes or two postal code prefixes of equal length.
+        "price": { # The price represented as a number and currency. # Fixed shipping price, represented as a number.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "region": "A String", # The geographic region to which a shipping rate applies. See [region](https://support.google.com/merchants/answer/6324484) for more information.
+        "service": "A String", # A free-form description of the service class or delivery speed.
+      },
+    ],
+    "shippingHeight": { # The ShippingDimension of the product. # Height of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shippingLabel": "A String", # The shipping label of the product, used to group product in account-level shipping rules.
+    "shippingLength": { # The ShippingDimension of the product. # Length of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shippingWeight": { # The ShippingWeight of the product. # Weight of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The weight of the product used to calculate the shipping cost of the item.
+    },
+    "shippingWidth": { # The ShippingDimension of the product. # Width of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shoppingAdsExcludedCountries": [ # List of country codes [(ISO 3166-1 alpha-2)](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in data source settings.
+      "A String",
+    ],
+    "size": "A String", # Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same `itemGroupId` value, see [Size](https://support.google.com/merchants/answer/6324492).
+    "sizeSystem": "A String", # System in which the size is specified. Recommended for apparel items. For more information, see [Size system](https://support.google.com/merchants/answer/6324502).
+    "sizeTypes": [ # The cut of the item. It can be used to represent combined size types for apparel items. Maximum two of size types can be provided, see [Size type](https://support.google.com/merchants/answer/6324497).
+      "A String",
+    ],
+    "structuredDescription": { # Structured description, for algorithmically (AI)-generated descriptions. # Structured description, for algorithmically (AI)-generated descriptions.
+      "content": "A String", # The description text Maximum length is 5000 characters
+      "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+    },
+    "structuredTitle": { # Structured title, for algorithmically (AI)-generated titles. # Structured title, for algorithmically (AI)-generated titles.
+      "content": "A String", # The title text Maximum length is 150 characters
+      "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+    },
+    "subscriptionCost": { # The SubscriptionCost of the product. # Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per subscription period.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "period": "A String", # The type of subscription period. Supported values are: * "`month`" * "`year`"
+      "periodLength": "A String", # The number of subscription periods the buyer has to pay.
+    },
+    "sustainabilityIncentives": [ # The list of sustainability incentive programs.
+      { # Information regarding sustainability-related incentive programs such as rebates or tax relief.
+        "amount": { # The price represented as a number and currency. # The fixed amount of the incentive.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "percentage": 3.14, # The percentage of the sale price that the incentive is applied to.
+        "type": "A String", # Sustainability incentive program.
+      },
+    ],
+    "title": "A String", # Title of the item.
+    "transitTimeLabel": "A String", # The transit time label of the product, used to group product in account-level transit time tables.
+    "unitPricingBaseMeasure": { # The UnitPricingBaseMeasure of the product. # The preference of the denominator of the unit price.
+      "unit": "A String", # The unit of the denominator.
+      "value": "A String", # The denominator of the unit price.
+    },
+    "unitPricingMeasure": { # The UnitPricingMeasure of the product. # The measure and dimension of an item.
+      "unit": "A String", # The unit of the measure.
+      "value": 3.14, # The measure of an item.
+    },
+    "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information.
+  },
+  "versionNumber": "A String", # Optional. Immutable. Represents the existing version (freshness) of the product, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing product. Re-insertion (for example, product refresh after 30 days) can be performed with the current `version_number`. Only supported for insertions into primary data sources. Do not set this field for updates. Do not set this field for insertions into supplemental data sources. If the operation is prevented, the aborted exception will be thrown.
+}

+

+
+

+    patch(name, body=None, dataSource=None, updateMask=None, x__xgafv=None)
+  
Updates the existing product input in your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.
+
+Args:
+  name: string, Identifier. The name of the product input. Format: `accounts/{account}/productInputs/{productinput}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # This resource represents input data you submit for a product, not the processed product that you see in Merchant Center, in Shopping ads, or across Google surfaces. Product inputs, rules and supplemental data source data are combined to create the processed Product. For more information, see [Manage products](/merchant/api/guides/products/overview). Required product input attributes to pass data validation checks are primarily defined in the [Products Data Specification](https://support.google.com/merchants/answer/188494). The following attributes are required: feedLabel, contentLanguage and offerId. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved. All fields in the product input and its sub-messages match the English name of their corresponding attribute in the [Products Data Specification](https://support.google.com/merchants/answer/188494) with [some exceptions](https://support.google.com/merchants/answer/7052112). The following reference documentation lists the field names in the **camelCase** casing style while the Products Data Specification lists the names in the **snake_case** casing style.
+  "contentLanguage": "A String", # Required. Immutable. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the product.
+  "customAttributes": [ # Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" }`). This is useful for submitting attributes not explicitly exposed by the API. Maximum allowed number of characters for each custom attribute is 10240 (represents sum of characters for name and value). Maximum 2500 custom attributes can be set per product, with total size of 102.4kB. Underscores in custom attribute names are replaced by spaces upon insertion.
+    { # A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.
+      "groupValues": [ # Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.
+        # Object with schema name: CustomAttribute
+      ],
+      "name": "A String", # The name of the attribute.
+      "value": "A String", # The value of the attribute. If `value` is not empty, `group_values` must be empty.
+    },
+  ],
+  "feedLabel": "A String", # Required. Immutable. The feed label that lets you categorize and identify your products. The maximum allowed characters are 20, and the supported characters are `A-Z`, `0-9`, hyphen, and underscore. The feed label must not include any spaces. For more information, see [Using feed labels](//support.google.com/merchants/answer/14994087).
+  "legacyLocal": True or False, # Immutable. Determines whether the product is **only** targeting local destinations and whether the product name should be distinguished with a `local~` prefix. For example, `accounts/123/productInputs/local~en~US~sku123`. If a product that is not `legacy_local` is already targeting local destinations, creating a `legacy_local` product with an otherwise matching name will fail.
+  "name": "A String", # Identifier. The name of the product input. Format: `accounts/{account}/productInputs/{productinput}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.
+  "offerId": "A String", # Required. Immutable. Your unique identifier for the product. This is the same for the product input and processed product. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. See the [products data specification](https://support.google.com/merchants/answer/188494#id) for details.
+  "product": "A String", # Output only. The name of the processed product. Format: `accounts/{account}/products/{product}`
+  "productAttributes": { # Product attributes. # Optional. A list of strongly-typed product attributes.
+    "additionalImageLinks": [ # Additional URLs of images of the item.
+      "A String",
+    ],
+    "adsGrouping": "A String", # Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
+    "adsLabels": [ # Similar to ads_grouping, but only works on CPC.
+      "A String",
+    ],
+    "adsRedirect": "A String", # Allows advertisers to override the item URL when the product is shown within the context of Product ads.
+    "adult": True or False, # Set to true if the item is targeted towards adults.
+    "ageGroup": "A String", # Target [age group](https://support.google.com/merchants/answer/6324463) of the item.
+    "autoPricingMinPrice": { # The price represented as a number and currency. # A safeguard in the [automated discounts] (https://support.google.com/merchants/answer/10295759) and "Dynamic Promotions" (https://support.google.com/merchants/answer/13949249) projects, ensuring that discounts on business offers do not fall below this value, thereby preserving the offer's value and profitability.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "availability": "A String", # [Availability](https://support.google.com/merchants/answer/6324448) status of the item.
+    "availabilityDate": "A String", # The day a pre-ordered product becomes available for delivery, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+    "brand": "A String", # [Brand](https://support.google.com/merchants/answer/6324351) of the item. For example, "Google".
+    "canonicalLink": "A String", # URL for the canonical version of your item's landing page.
+    "certifications": [ # Product Certifications, for example for energy efficiency labeling of products recorded in the [EU EPREL](https://eprel.ec.europa.eu/screen/home) database. See the [Help Center](https://support.google.com/merchants/answer/13528839) article for more information.
+      { # Product [certification](https://support.google.com/merchants/answer/13528839), initially introduced for EU energy efficiency labeling compliance using the EU EPREL database.
+        "certificationAuthority": "A String", # The certification authority.
+        "certificationCode": "A String", # The certification code. Maximum length is 2000 characters.
+        "certificationName": "A String", # The name of the certification.
+        "certificationValue": "A String", # The certification value (also known as class, level or grade), for example "A+", "C", "gold". Maximum length is 2000 characters.
+      },
+    ],
+    "cloudExportAdditionalProperties": [ # Extra fields to export to the Cloud Retail program.
+      { # Product property for the Cloud Retail API. For example, properties for a TV product could be "Screen-Resolution" or "Screen-Size".
+        "boolValue": True or False, # Boolean value of the given property. For example for a TV product, "True" or "False" if the screen is UHD.
+        "floatValue": [ # Float values of the given property. For example for a TV product 1.2345. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+          3.14,
+        ],
+        "intValue": [ # Integer values of the given property. For example, 1080 for a TV product's Screen Resolution. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+          "A String",
+        ],
+        "maxValue": 3.14, # Maximum float value of the given property. For example for a TV product 100.00.
+        "minValue": 3.14, # Minimum float value of the given property. For example for a TV product 1.00.
+        "propertyName": "A String", # Name of the given property. For example, "Screen-Resolution" for a TV product. Maximum string size is 256 characters.
+        "textValue": [ # Text value of the given property. For example, "8K(UHD)" could be a text value for a TV product. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order. Maximum string size is 256 characters.
+          "A String",
+        ],
+        "unitCode": "A String", # Unit of the given property. For example, "Pixels" for a TV product. Maximum string size is 256B.
+      },
+    ],
+    "color": "A String", # [Color](https://support.google.com/merchants/answer/6324487) of the item. For example, "red".
+    "condition": "A String", # [Condition](https://support.google.com/merchants/answer/6324469) or state of the item.
+    "costOfGoodsSold": { # The price represented as a number and currency. # Cost of goods sold. Used for gross profit reporting.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "customLabel0": "A String", # [Custom label 0](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel1": "A String", # [Custom label 1](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel2": "A String", # [Custom label 2](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel3": "A String", # [Custom label 3](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel4": "A String", # [Custom label 4](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "description": "A String", # Description of the item.
+    "disclosureDate": "A String", # The date time when an offer becomes visible in search results across Google’s YouTube surfaces, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. See [Disclosure date](https://support.google.com/merchants/answer/13034208) for more information.
+    "displayAdsId": "A String", # An identifier for an item for dynamic remarketing campaigns.
+    "displayAdsLink": "A String", # URL directly to your item's landing page for dynamic remarketing campaigns.
+    "displayAdsSimilarIds": [ # Advertiser-specified recommendations. For more information, see [Display ads attribute specification](https://support.google.com/merchants/answer/6069387).
+      "A String",
+    ],
+    "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](https://support.google.com/merchants/answer/7562785) 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.
+      "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.
+    "externalSellerId": "A String", # Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account.
+    "freeShippingThreshold": [ # Conditions to be met for a product to have free shipping.
+      { # Conditions to be met for a product to have free shipping.
+        "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+        "priceThreshold": { # The price represented as a number and currency. # The minimum product price for the shipping cost to become free. Represented as a number.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+      },
+    ],
+    "gender": "A String", # Target [gender](https://support.google.com/merchants/answer/6324479) of the item.
+    "googleProductCategory": "A String", # Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
+    "gtins": [ # Global Trade Item Numbers ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item. You can provide up to 10 GTINs.
+      "A String",
+    ],
+    "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.
+      "A String",
+    ],
+    "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per month.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "creditType": "A String", # Type of installment payments.
+      "downpayment": { # The price represented as a number and currency. # The up-front down payment amount the buyer has to pay.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "months": "A String", # The number of installments the buyer has to pay.
+    },
+    "isBundle": True or False, # Whether the item is a business-defined sub-API. A [sub-API] (https://support.google.com/merchants/answer/6324449) is a custom grouping of different products sold by a business for a single price.
+    "itemGroupId": "A String", # Shared identifier for all variants of the same product.
+    "lifestyleImageLinks": [ # Additional URLs of lifestyle images of the item, used to explicitly identify images that showcase your item in a real-world context. See the [Help Center article](https://support.google.com/merchants/answer/9103186) for more information.
+      "A String",
+    ],
+    "link": "A String", # URL directly linking to your item's page on your online store.
+    "linkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13871172) for business hosted local storefront.
+    "loyaltyPoints": { # A message that represents loyalty points. # Loyalty points that users receive after purchasing the item. Japan only.
+      "name": "A String", # Name of loyalty points program. It is recommended to limit the name to 12 full-width characters or 24 Roman characters.
+      "pointsValue": "A String", # The retailer's loyalty points in absolute value.
+      "ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.
+    },
+    "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item.
+      { # A message that represents loyalty program.
+        "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "loyaltyPoints": "A String", # The amount of loyalty points earned on a purchase.
+        "memberPriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # A date range during which the item is eligible for member price. If not specified, the member price is always applicable. The date range is represented by a pair of ISO 8601 dates separated by a space, comma, or slash.
+          "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+          "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+        },
+        "price": { # The price represented as a number and currency. # The price for members of the given tier, that is, the instant discount price. Must be smaller or equal to the regular price.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "programLabel": "A String", # The label of the loyalty program. This is an internal label that uniquely identifies the relationship between a business entity and a loyalty program entity. The label must be provided so that the system can associate the assets below (for example, price and points) with a business. The corresponding program must be linked to the Merchant Center account.
+        "shippingLabel": "A String", # The label of the shipping benefit. If the field has value, this offer has loyalty shipping benefit. If the field value isn't provided, the item is not eligible for loyalty shipping for the given loyalty tier.
+        "tierLabel": "A String", # The label of the tier within the loyalty program. Must match one of the labels within the program.
+      },
+    ],
+    "material": "A String", # The [material](https://support.google.com/merchants/answer/6324410) of which the item is made. For example, "Leather" or "Cotton".
+    "maxEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+    "maxHandlingTime": "A String", # Maximal product handling time (in business days).
+    "maximumRetailPrice": { # The price represented as a number and currency. # Maximum retail price (MRP) of the item. Applicable to India only.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "minEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+    "minHandlingTime": "A String", # Minimal product handling time (in business days).
+    "mobileLink": "A String", # URL for the mobile-optimized version of your item's landing page.
+    "mobileLinkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13870216) for business hosted local storefront optimized for mobile devices.
+    "mpn": "A String", # Manufacturer Part Number ([MPN](https://support.google.com/merchants/answer/188494#mpn)) of the item.
+    "multipack": "A String", # The number of identical products in a business-defined multipack.
+    "pattern": "A String", # The item's [pattern](https://support.google.com/merchants/answer/6324483). For example, polka dots.
+    "pause": "A String", # Publication of this item will be temporarily [paused](https://support.google.com/merchants/answer/11909930).
+    "pickupMethod": "A String", # The [pickup](https://support.google.com/merchants/answer/14634021) option for the item.
+    "pickupSla": "A String", # Item store pickup timeline. For more information, see [Pickup SLA](https://support.google.com/merchants/answer/14635400).
+    "price": { # The price represented as a number and currency. # Price of the item.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "productDetails": [ # Technical specification or additional product details.
+      { # The product details.
+        "attributeName": "A String", # The name of the product detail.
+        "attributeValue": "A String", # The value of the product detail.
+        "sectionName": "A String", # The section header used to group a set of product details.
+      },
+    ],
+    "productHeight": { # The dimension of the product. # The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "productHighlights": [ # Bullet points describing the most relevant [product highlights](https://support.google.com/merchants/answer/9216100).
+      "A String",
+    ],
+    "productLength": { # The dimension of the product. # The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "productTypes": [ # Categories of the item (formatted as in [product data specification](https://support.google.com/merchants/answer/7052112#product_category)).
+      "A String",
+    ],
+    "productWeight": { # The weight of the product. # The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).
+      "unit": "A String", # Required. The weight unit. Acceptable values are: * "`g`" * "`kg`" * "`oz`" * "`lb`"
+      "value": 3.14, # Required. The weight represented as a number. The weight can have a maximum precision of four decimal places.
+    },
+    "productWidth": { # The dimension of the product. # The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "promotionIds": [ # The unique ID of a promotion.
+      "A String",
+    ],
+    "salePrice": { # The price represented as a number and currency. # Advertised sale price of the item.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Date range during which the item is on sale, see [product data specification](https://support.google.com/merchants/answer/7052112#price_and_availability).
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+    "sellOnGoogleQuantity": "A String", # The quantity of the product that is available for selling on Google. Supported only for online products.
+    "shipping": [ # Shipping rules.
+      { # The Shipping of the product.
+        "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+        "locationGroupName": "A String", # The location where the shipping is applicable, represented by a location group name.
+        "locationId": "A String", # The numeric ID of a location that the shipping rate applies to as defined in the [AdWords API](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
+        "maxHandlingTime": "A String", # Maximum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minHandlingTime is optional if maxHandlingTime is present.
+        "maxTransitTime": "A String", # Maximum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minTransitTime is optional if maxTransitTime is present.
+        "minHandlingTime": "A String", # Minimum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. minHandlingTime can only be present together with maxHandlingTime; but it is not required if maxHandlingTime is present.
+        "minTransitTime": "A String", # Minimum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. minTransitTime can only be present together with maxTransitTime; but it is not required if maxTransitTime is present.
+        "postalCode": "A String", # The postal code range that the shipping rate applies to, represented by a postal code, a postal code prefix followed by a * wildcard, a range between two postal codes or two postal code prefixes of equal length.
+        "price": { # The price represented as a number and currency. # Fixed shipping price, represented as a number.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "region": "A String", # The geographic region to which a shipping rate applies. See [region](https://support.google.com/merchants/answer/6324484) for more information.
+        "service": "A String", # A free-form description of the service class or delivery speed.
+      },
+    ],
+    "shippingHeight": { # The ShippingDimension of the product. # Height of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shippingLabel": "A String", # The shipping label of the product, used to group product in account-level shipping rules.
+    "shippingLength": { # The ShippingDimension of the product. # Length of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shippingWeight": { # The ShippingWeight of the product. # Weight of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The weight of the product used to calculate the shipping cost of the item.
+    },
+    "shippingWidth": { # The ShippingDimension of the product. # Width of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shoppingAdsExcludedCountries": [ # List of country codes [(ISO 3166-1 alpha-2)](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in data source settings.
+      "A String",
+    ],
+    "size": "A String", # Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same `itemGroupId` value, see [Size](https://support.google.com/merchants/answer/6324492).
+    "sizeSystem": "A String", # System in which the size is specified. Recommended for apparel items. For more information, see [Size system](https://support.google.com/merchants/answer/6324502).
+    "sizeTypes": [ # The cut of the item. It can be used to represent combined size types for apparel items. Maximum two of size types can be provided, see [Size type](https://support.google.com/merchants/answer/6324497).
+      "A String",
+    ],
+    "structuredDescription": { # Structured description, for algorithmically (AI)-generated descriptions. # Structured description, for algorithmically (AI)-generated descriptions.
+      "content": "A String", # The description text Maximum length is 5000 characters
+      "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+    },
+    "structuredTitle": { # Structured title, for algorithmically (AI)-generated titles. # Structured title, for algorithmically (AI)-generated titles.
+      "content": "A String", # The title text Maximum length is 150 characters
+      "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+    },
+    "subscriptionCost": { # The SubscriptionCost of the product. # Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per subscription period.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "period": "A String", # The type of subscription period. Supported values are: * "`month`" * "`year`"
+      "periodLength": "A String", # The number of subscription periods the buyer has to pay.
+    },
+    "sustainabilityIncentives": [ # The list of sustainability incentive programs.
+      { # Information regarding sustainability-related incentive programs such as rebates or tax relief.
+        "amount": { # The price represented as a number and currency. # The fixed amount of the incentive.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "percentage": 3.14, # The percentage of the sale price that the incentive is applied to.
+        "type": "A String", # Sustainability incentive program.
+      },
+    ],
+    "title": "A String", # Title of the item.
+    "transitTimeLabel": "A String", # The transit time label of the product, used to group product in account-level transit time tables.
+    "unitPricingBaseMeasure": { # The UnitPricingBaseMeasure of the product. # The preference of the denominator of the unit price.
+      "unit": "A String", # The unit of the denominator.
+      "value": "A String", # The denominator of the unit price.
+    },
+    "unitPricingMeasure": { # The UnitPricingMeasure of the product. # The measure and dimension of an item.
+      "unit": "A String", # The unit of the measure.
+      "value": 3.14, # The measure of an item.
+    },
+    "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information.
+  },
+  "versionNumber": "A String", # Optional. Immutable. Represents the existing version (freshness) of the product, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing product. Re-insertion (for example, product refresh after 30 days) can be performed with the current `version_number`. Only supported for insertions into primary data sources. Do not set this field for updates. Do not set this field for insertions into supplemental data sources. If the operation is prevented, the aborted exception will be thrown.
+}
+
+  dataSource: string, Required. The primary or supplemental product data source where `data_source` name identifies the product input to be updated. Only API data sources are supported. Format: `accounts/{account}/dataSources/{datasource}`. For example, `accounts/123456/dataSources/104628`.
+  updateMask: string, Optional. The list of product attributes to be updated. If the update mask is omitted, then it is treated as implied field mask equivalent to all fields that are populated (have a non-empty value). Attributes specified in the update mask without a value specified in the body will be deleted from the product. Update mask can only be specified for top level fields in attributes and custom attributes. To specify the update mask for custom attributes you need to add the `custom_attribute.` prefix. Providing special "*" value for full product replacement is not supported.
+  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 input data you submit for a product, not the processed product that you see in Merchant Center, in Shopping ads, or across Google surfaces. Product inputs, rules and supplemental data source data are combined to create the processed Product. For more information, see [Manage products](/merchant/api/guides/products/overview). Required product input attributes to pass data validation checks are primarily defined in the [Products Data Specification](https://support.google.com/merchants/answer/188494). The following attributes are required: feedLabel, contentLanguage and offerId. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved. All fields in the product input and its sub-messages match the English name of their corresponding attribute in the [Products Data Specification](https://support.google.com/merchants/answer/188494) with [some exceptions](https://support.google.com/merchants/answer/7052112). The following reference documentation lists the field names in the **camelCase** casing style while the Products Data Specification lists the names in the **snake_case** casing style.
+  "contentLanguage": "A String", # Required. Immutable. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the product.
+  "customAttributes": [ # Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" }`). This is useful for submitting attributes not explicitly exposed by the API. Maximum allowed number of characters for each custom attribute is 10240 (represents sum of characters for name and value). Maximum 2500 custom attributes can be set per product, with total size of 102.4kB. Underscores in custom attribute names are replaced by spaces upon insertion.
+    { # A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.
+      "groupValues": [ # Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.
+        # Object with schema name: CustomAttribute
+      ],
+      "name": "A String", # The name of the attribute.
+      "value": "A String", # The value of the attribute. If `value` is not empty, `group_values` must be empty.
+    },
+  ],
+  "feedLabel": "A String", # Required. Immutable. The feed label that lets you categorize and identify your products. The maximum allowed characters are 20, and the supported characters are `A-Z`, `0-9`, hyphen, and underscore. The feed label must not include any spaces. For more information, see [Using feed labels](//support.google.com/merchants/answer/14994087).
+  "legacyLocal": True or False, # Immutable. Determines whether the product is **only** targeting local destinations and whether the product name should be distinguished with a `local~` prefix. For example, `accounts/123/productInputs/local~en~US~sku123`. If a product that is not `legacy_local` is already targeting local destinations, creating a `legacy_local` product with an otherwise matching name will fail.
+  "name": "A String", # Identifier. The name of the product input. Format: `accounts/{account}/productInputs/{productinput}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.
+  "offerId": "A String", # Required. Immutable. Your unique identifier for the product. This is the same for the product input and processed product. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. See the [products data specification](https://support.google.com/merchants/answer/188494#id) for details.
+  "product": "A String", # Output only. The name of the processed product. Format: `accounts/{account}/products/{product}`
+  "productAttributes": { # Product attributes. # Optional. A list of strongly-typed product attributes.
+    "additionalImageLinks": [ # Additional URLs of images of the item.
+      "A String",
+    ],
+    "adsGrouping": "A String", # Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
+    "adsLabels": [ # Similar to ads_grouping, but only works on CPC.
+      "A String",
+    ],
+    "adsRedirect": "A String", # Allows advertisers to override the item URL when the product is shown within the context of Product ads.
+    "adult": True or False, # Set to true if the item is targeted towards adults.
+    "ageGroup": "A String", # Target [age group](https://support.google.com/merchants/answer/6324463) of the item.
+    "autoPricingMinPrice": { # The price represented as a number and currency. # A safeguard in the [automated discounts] (https://support.google.com/merchants/answer/10295759) and "Dynamic Promotions" (https://support.google.com/merchants/answer/13949249) projects, ensuring that discounts on business offers do not fall below this value, thereby preserving the offer's value and profitability.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "availability": "A String", # [Availability](https://support.google.com/merchants/answer/6324448) status of the item.
+    "availabilityDate": "A String", # The day a pre-ordered product becomes available for delivery, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+    "brand": "A String", # [Brand](https://support.google.com/merchants/answer/6324351) of the item. For example, "Google".
+    "canonicalLink": "A String", # URL for the canonical version of your item's landing page.
+    "certifications": [ # Product Certifications, for example for energy efficiency labeling of products recorded in the [EU EPREL](https://eprel.ec.europa.eu/screen/home) database. See the [Help Center](https://support.google.com/merchants/answer/13528839) article for more information.
+      { # Product [certification](https://support.google.com/merchants/answer/13528839), initially introduced for EU energy efficiency labeling compliance using the EU EPREL database.
+        "certificationAuthority": "A String", # The certification authority.
+        "certificationCode": "A String", # The certification code. Maximum length is 2000 characters.
+        "certificationName": "A String", # The name of the certification.
+        "certificationValue": "A String", # The certification value (also known as class, level or grade), for example "A+", "C", "gold". Maximum length is 2000 characters.
+      },
+    ],
+    "cloudExportAdditionalProperties": [ # Extra fields to export to the Cloud Retail program.
+      { # Product property for the Cloud Retail API. For example, properties for a TV product could be "Screen-Resolution" or "Screen-Size".
+        "boolValue": True or False, # Boolean value of the given property. For example for a TV product, "True" or "False" if the screen is UHD.
+        "floatValue": [ # Float values of the given property. For example for a TV product 1.2345. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+          3.14,
+        ],
+        "intValue": [ # Integer values of the given property. For example, 1080 for a TV product's Screen Resolution. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+          "A String",
+        ],
+        "maxValue": 3.14, # Maximum float value of the given property. For example for a TV product 100.00.
+        "minValue": 3.14, # Minimum float value of the given property. For example for a TV product 1.00.
+        "propertyName": "A String", # Name of the given property. For example, "Screen-Resolution" for a TV product. Maximum string size is 256 characters.
+        "textValue": [ # Text value of the given property. For example, "8K(UHD)" could be a text value for a TV product. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order. Maximum string size is 256 characters.
+          "A String",
+        ],
+        "unitCode": "A String", # Unit of the given property. For example, "Pixels" for a TV product. Maximum string size is 256B.
+      },
+    ],
+    "color": "A String", # [Color](https://support.google.com/merchants/answer/6324487) of the item. For example, "red".
+    "condition": "A String", # [Condition](https://support.google.com/merchants/answer/6324469) or state of the item.
+    "costOfGoodsSold": { # The price represented as a number and currency. # Cost of goods sold. Used for gross profit reporting.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "customLabel0": "A String", # [Custom label 0](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel1": "A String", # [Custom label 1](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel2": "A String", # [Custom label 2](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel3": "A String", # [Custom label 3](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel4": "A String", # [Custom label 4](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "description": "A String", # Description of the item.
+    "disclosureDate": "A String", # The date time when an offer becomes visible in search results across Google’s YouTube surfaces, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. See [Disclosure date](https://support.google.com/merchants/answer/13034208) for more information.
+    "displayAdsId": "A String", # An identifier for an item for dynamic remarketing campaigns.
+    "displayAdsLink": "A String", # URL directly to your item's landing page for dynamic remarketing campaigns.
+    "displayAdsSimilarIds": [ # Advertiser-specified recommendations. For more information, see [Display ads attribute specification](https://support.google.com/merchants/answer/6069387).
+      "A String",
+    ],
+    "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](https://support.google.com/merchants/answer/7562785) 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.
+      "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.
+    "externalSellerId": "A String", # Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account.
+    "freeShippingThreshold": [ # Conditions to be met for a product to have free shipping.
+      { # Conditions to be met for a product to have free shipping.
+        "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+        "priceThreshold": { # The price represented as a number and currency. # The minimum product price for the shipping cost to become free. Represented as a number.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+      },
+    ],
+    "gender": "A String", # Target [gender](https://support.google.com/merchants/answer/6324479) of the item.
+    "googleProductCategory": "A String", # Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
+    "gtins": [ # Global Trade Item Numbers ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item. You can provide up to 10 GTINs.
+      "A String",
+    ],
+    "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.
+      "A String",
+    ],
+    "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per month.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "creditType": "A String", # Type of installment payments.
+      "downpayment": { # The price represented as a number and currency. # The up-front down payment amount the buyer has to pay.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "months": "A String", # The number of installments the buyer has to pay.
+    },
+    "isBundle": True or False, # Whether the item is a business-defined sub-API. A [sub-API] (https://support.google.com/merchants/answer/6324449) is a custom grouping of different products sold by a business for a single price.
+    "itemGroupId": "A String", # Shared identifier for all variants of the same product.
+    "lifestyleImageLinks": [ # Additional URLs of lifestyle images of the item, used to explicitly identify images that showcase your item in a real-world context. See the [Help Center article](https://support.google.com/merchants/answer/9103186) for more information.
+      "A String",
+    ],
+    "link": "A String", # URL directly linking to your item's page on your online store.
+    "linkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13871172) for business hosted local storefront.
+    "loyaltyPoints": { # A message that represents loyalty points. # Loyalty points that users receive after purchasing the item. Japan only.
+      "name": "A String", # Name of loyalty points program. It is recommended to limit the name to 12 full-width characters or 24 Roman characters.
+      "pointsValue": "A String", # The retailer's loyalty points in absolute value.
+      "ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.
+    },
+    "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item.
+      { # A message that represents loyalty program.
+        "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "loyaltyPoints": "A String", # The amount of loyalty points earned on a purchase.
+        "memberPriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # A date range during which the item is eligible for member price. If not specified, the member price is always applicable. The date range is represented by a pair of ISO 8601 dates separated by a space, comma, or slash.
+          "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+          "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+        },
+        "price": { # The price represented as a number and currency. # The price for members of the given tier, that is, the instant discount price. Must be smaller or equal to the regular price.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "programLabel": "A String", # The label of the loyalty program. This is an internal label that uniquely identifies the relationship between a business entity and a loyalty program entity. The label must be provided so that the system can associate the assets below (for example, price and points) with a business. The corresponding program must be linked to the Merchant Center account.
+        "shippingLabel": "A String", # The label of the shipping benefit. If the field has value, this offer has loyalty shipping benefit. If the field value isn't provided, the item is not eligible for loyalty shipping for the given loyalty tier.
+        "tierLabel": "A String", # The label of the tier within the loyalty program. Must match one of the labels within the program.
+      },
+    ],
+    "material": "A String", # The [material](https://support.google.com/merchants/answer/6324410) of which the item is made. For example, "Leather" or "Cotton".
+    "maxEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+    "maxHandlingTime": "A String", # Maximal product handling time (in business days).
+    "maximumRetailPrice": { # The price represented as a number and currency. # Maximum retail price (MRP) of the item. Applicable to India only.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "minEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+    "minHandlingTime": "A String", # Minimal product handling time (in business days).
+    "mobileLink": "A String", # URL for the mobile-optimized version of your item's landing page.
+    "mobileLinkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13870216) for business hosted local storefront optimized for mobile devices.
+    "mpn": "A String", # Manufacturer Part Number ([MPN](https://support.google.com/merchants/answer/188494#mpn)) of the item.
+    "multipack": "A String", # The number of identical products in a business-defined multipack.
+    "pattern": "A String", # The item's [pattern](https://support.google.com/merchants/answer/6324483). For example, polka dots.
+    "pause": "A String", # Publication of this item will be temporarily [paused](https://support.google.com/merchants/answer/11909930).
+    "pickupMethod": "A String", # The [pickup](https://support.google.com/merchants/answer/14634021) option for the item.
+    "pickupSla": "A String", # Item store pickup timeline. For more information, see [Pickup SLA](https://support.google.com/merchants/answer/14635400).
+    "price": { # The price represented as a number and currency. # Price of the item.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "productDetails": [ # Technical specification or additional product details.
+      { # The product details.
+        "attributeName": "A String", # The name of the product detail.
+        "attributeValue": "A String", # The value of the product detail.
+        "sectionName": "A String", # The section header used to group a set of product details.
+      },
+    ],
+    "productHeight": { # The dimension of the product. # The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "productHighlights": [ # Bullet points describing the most relevant [product highlights](https://support.google.com/merchants/answer/9216100).
+      "A String",
+    ],
+    "productLength": { # The dimension of the product. # The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "productTypes": [ # Categories of the item (formatted as in [product data specification](https://support.google.com/merchants/answer/7052112#product_category)).
+      "A String",
+    ],
+    "productWeight": { # The weight of the product. # The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).
+      "unit": "A String", # Required. The weight unit. Acceptable values are: * "`g`" * "`kg`" * "`oz`" * "`lb`"
+      "value": 3.14, # Required. The weight represented as a number. The weight can have a maximum precision of four decimal places.
+    },
+    "productWidth": { # The dimension of the product. # The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "promotionIds": [ # The unique ID of a promotion.
+      "A String",
+    ],
+    "salePrice": { # The price represented as a number and currency. # Advertised sale price of the item.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Date range during which the item is on sale, see [product data specification](https://support.google.com/merchants/answer/7052112#price_and_availability).
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+    "sellOnGoogleQuantity": "A String", # The quantity of the product that is available for selling on Google. Supported only for online products.
+    "shipping": [ # Shipping rules.
+      { # The Shipping of the product.
+        "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+        "locationGroupName": "A String", # The location where the shipping is applicable, represented by a location group name.
+        "locationId": "A String", # The numeric ID of a location that the shipping rate applies to as defined in the [AdWords API](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
+        "maxHandlingTime": "A String", # Maximum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minHandlingTime is optional if maxHandlingTime is present.
+        "maxTransitTime": "A String", # Maximum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minTransitTime is optional if maxTransitTime is present.
+        "minHandlingTime": "A String", # Minimum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. minHandlingTime can only be present together with maxHandlingTime; but it is not required if maxHandlingTime is present.
+        "minTransitTime": "A String", # Minimum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. minTransitTime can only be present together with maxTransitTime; but it is not required if maxTransitTime is present.
+        "postalCode": "A String", # The postal code range that the shipping rate applies to, represented by a postal code, a postal code prefix followed by a * wildcard, a range between two postal codes or two postal code prefixes of equal length.
+        "price": { # The price represented as a number and currency. # Fixed shipping price, represented as a number.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "region": "A String", # The geographic region to which a shipping rate applies. See [region](https://support.google.com/merchants/answer/6324484) for more information.
+        "service": "A String", # A free-form description of the service class or delivery speed.
+      },
+    ],
+    "shippingHeight": { # The ShippingDimension of the product. # Height of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shippingLabel": "A String", # The shipping label of the product, used to group product in account-level shipping rules.
+    "shippingLength": { # The ShippingDimension of the product. # Length of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shippingWeight": { # The ShippingWeight of the product. # Weight of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The weight of the product used to calculate the shipping cost of the item.
+    },
+    "shippingWidth": { # The ShippingDimension of the product. # Width of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shoppingAdsExcludedCountries": [ # List of country codes [(ISO 3166-1 alpha-2)](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in data source settings.
+      "A String",
+    ],
+    "size": "A String", # Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same `itemGroupId` value, see [Size](https://support.google.com/merchants/answer/6324492).
+    "sizeSystem": "A String", # System in which the size is specified. Recommended for apparel items. For more information, see [Size system](https://support.google.com/merchants/answer/6324502).
+    "sizeTypes": [ # The cut of the item. It can be used to represent combined size types for apparel items. Maximum two of size types can be provided, see [Size type](https://support.google.com/merchants/answer/6324497).
+      "A String",
+    ],
+    "structuredDescription": { # Structured description, for algorithmically (AI)-generated descriptions. # Structured description, for algorithmically (AI)-generated descriptions.
+      "content": "A String", # The description text Maximum length is 5000 characters
+      "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+    },
+    "structuredTitle": { # Structured title, for algorithmically (AI)-generated titles. # Structured title, for algorithmically (AI)-generated titles.
+      "content": "A String", # The title text Maximum length is 150 characters
+      "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+    },
+    "subscriptionCost": { # The SubscriptionCost of the product. # Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per subscription period.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "period": "A String", # The type of subscription period. Supported values are: * "`month`" * "`year`"
+      "periodLength": "A String", # The number of subscription periods the buyer has to pay.
+    },
+    "sustainabilityIncentives": [ # The list of sustainability incentive programs.
+      { # Information regarding sustainability-related incentive programs such as rebates or tax relief.
+        "amount": { # The price represented as a number and currency. # The fixed amount of the incentive.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "percentage": 3.14, # The percentage of the sale price that the incentive is applied to.
+        "type": "A String", # Sustainability incentive program.
+      },
+    ],
+    "title": "A String", # Title of the item.
+    "transitTimeLabel": "A String", # The transit time label of the product, used to group product in account-level transit time tables.
+    "unitPricingBaseMeasure": { # The UnitPricingBaseMeasure of the product. # The preference of the denominator of the unit price.
+      "unit": "A String", # The unit of the denominator.
+      "value": "A String", # The denominator of the unit price.
+    },
+    "unitPricingMeasure": { # The UnitPricingMeasure of the product. # The measure and dimension of an item.
+      "unit": "A String", # The unit of the measure.
+      "value": 3.14, # The measure of an item.
+    },
+    "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information.
+  },
+  "versionNumber": "A String", # Optional. Immutable. Represents the existing version (freshness) of the product, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing product. Re-insertion (for example, product refresh after 30 days) can be performed with the current `version_number`. Only supported for insertions into primary data sources. Do not set this field for updates. Do not set this field for insertions into supplemental data sources. If the operation is prevented, the aborted exception will be thrown.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_products_v1.accounts.products.html b/docs/dyn/merchantapi_products_v1.accounts.products.html
new file mode 100644
index 00000000000..63ad96b685e
--- /dev/null
+++ b/docs/dyn/merchantapi_products_v1.accounts.products.html
@@ -0,0 +1,834 @@
+
+
+
+
Merchant API . accounts . products

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

+
Retrieves the processed product from your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the updated final product can be retrieved.

+

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

+
Lists the processed products in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested. After inserting, updating, or deleting a product input, it may take several minutes before the updated processed product can be retrieved.

+

+  list_next()

+
Retrieves the next page of results.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    get(name, x__xgafv=None)
+  
Retrieves the processed product from your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the updated final product can be retrieved.
+
+Args:
+  name: string, Required. The name of the product to retrieve. Format: `accounts/{account}/products/{product}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/products/en~US~sku123`. A legacy local product name would be `accounts/123/products/local~en~US~sku123`. Note: For calls to the v1beta version, the `product` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/products/online~en~US~sku123`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The processed product, built from multiple product inputs after applying rules and supplemental data sources. This processed product matches what is shown in your Merchant Center account. Each product is built from exactly one primary data source product input, and multiple supplemental data source inputs. After inserting, updating, or deleting a product input, it may take several minutes before the updated processed product can be retrieved. All fields in the processed product and its sub-messages match the name of their corresponding attribute in the [Product data specification](https://support.google.com/merchants/answer/7052112) with some exceptions.
+  "automatedDiscounts": { # Information regarding Automated Discounts. # Output only. The automated discounts information for the product.
+    "gadPrice": { # The price represented as a number and currency. # The current sale price for products with a price optimized using Google Automated Discounts (GAD). Absent if the information about the GAD_price of the product is not available.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "priorPrice": { # The price represented as a number and currency. # The price prior to the application of the first price reduction. Absent if the information about the prior price of the product is not available.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "priorPriceProgressive": { # The price represented as a number and currency. # The price prior to the application of consecutive price reductions. Absent if the information about the prior price of the product is not available.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+  },
+  "contentLanguage": "A String", # Output only. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the product.
+  "customAttributes": [ # Output only. A list of custom (merchant-provided) attributes. It can also be used to submit any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" }`). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google.
+    { # A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.
+      "groupValues": [ # Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.
+        # Object with schema name: CustomAttribute
+      ],
+      "name": "A String", # The name of the attribute.
+      "value": "A String", # The value of the attribute. If `value` is not empty, `group_values` must be empty.
+    },
+  ],
+  "dataSource": "A String", # Output only. The primary data source of the product.
+  "feedLabel": "A String", # Output only. The feed label lets you categorize and identify your products. The maximum allowed characters is 20 and the supported characters are`A-Z`, `0-9`, hyphen and underscore. The feed label must not include any spaces. For more information, see [Using feed labels](//support.google.com/merchants/answer/14994087)
+  "legacyLocal": True or False, # Output only. Determines whether the product is **only** targeting local destinations and whether the product name should be distinguished with a `local~` prefix. For example, `accounts/123/products/local~en~US~sku123`.
+  "name": "A String", # The name of the product. Format: `accounts/{account}/products/{product}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/products/en~US~sku123`. A legacy local product name would be `accounts/123/products/local~en~US~sku123`. Note: For calls to the v1beta version, the `product` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/products/online~en~US~sku123`.
+  "offerId": "A String", # Output only. Your unique identifier for the product. This is the same for the product input and processed product. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. See the [product data specification](https://support.google.com/merchants/answer/188494#id) for details.
+  "productAttributes": { # Product attributes. # Output only. A list of strongly-typed product attributes.
+    "additionalImageLinks": [ # Additional URLs of images of the item.
+      "A String",
+    ],
+    "adsGrouping": "A String", # Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
+    "adsLabels": [ # Similar to ads_grouping, but only works on CPC.
+      "A String",
+    ],
+    "adsRedirect": "A String", # Allows advertisers to override the item URL when the product is shown within the context of Product ads.
+    "adult": True or False, # Set to true if the item is targeted towards adults.
+    "ageGroup": "A String", # Target [age group](https://support.google.com/merchants/answer/6324463) of the item.
+    "autoPricingMinPrice": { # The price represented as a number and currency. # A safeguard in the [automated discounts] (https://support.google.com/merchants/answer/10295759) and "Dynamic Promotions" (https://support.google.com/merchants/answer/13949249) projects, ensuring that discounts on business offers do not fall below this value, thereby preserving the offer's value and profitability.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "availability": "A String", # [Availability](https://support.google.com/merchants/answer/6324448) status of the item.
+    "availabilityDate": "A String", # The day a pre-ordered product becomes available for delivery, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+    "brand": "A String", # [Brand](https://support.google.com/merchants/answer/6324351) of the item. For example, "Google".
+    "canonicalLink": "A String", # URL for the canonical version of your item's landing page.
+    "certifications": [ # Product Certifications, for example for energy efficiency labeling of products recorded in the [EU EPREL](https://eprel.ec.europa.eu/screen/home) database. See the [Help Center](https://support.google.com/merchants/answer/13528839) article for more information.
+      { # Product [certification](https://support.google.com/merchants/answer/13528839), initially introduced for EU energy efficiency labeling compliance using the EU EPREL database.
+        "certificationAuthority": "A String", # The certification authority.
+        "certificationCode": "A String", # The certification code. Maximum length is 2000 characters.
+        "certificationName": "A String", # The name of the certification.
+        "certificationValue": "A String", # The certification value (also known as class, level or grade), for example "A+", "C", "gold". Maximum length is 2000 characters.
+      },
+    ],
+    "cloudExportAdditionalProperties": [ # Extra fields to export to the Cloud Retail program.
+      { # Product property for the Cloud Retail API. For example, properties for a TV product could be "Screen-Resolution" or "Screen-Size".
+        "boolValue": True or False, # Boolean value of the given property. For example for a TV product, "True" or "False" if the screen is UHD.
+        "floatValue": [ # Float values of the given property. For example for a TV product 1.2345. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+          3.14,
+        ],
+        "intValue": [ # Integer values of the given property. For example, 1080 for a TV product's Screen Resolution. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+          "A String",
+        ],
+        "maxValue": 3.14, # Maximum float value of the given property. For example for a TV product 100.00.
+        "minValue": 3.14, # Minimum float value of the given property. For example for a TV product 1.00.
+        "propertyName": "A String", # Name of the given property. For example, "Screen-Resolution" for a TV product. Maximum string size is 256 characters.
+        "textValue": [ # Text value of the given property. For example, "8K(UHD)" could be a text value for a TV product. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order. Maximum string size is 256 characters.
+          "A String",
+        ],
+        "unitCode": "A String", # Unit of the given property. For example, "Pixels" for a TV product. Maximum string size is 256B.
+      },
+    ],
+    "color": "A String", # [Color](https://support.google.com/merchants/answer/6324487) of the item. For example, "red".
+    "condition": "A String", # [Condition](https://support.google.com/merchants/answer/6324469) or state of the item.
+    "costOfGoodsSold": { # The price represented as a number and currency. # Cost of goods sold. Used for gross profit reporting.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "customLabel0": "A String", # [Custom label 0](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel1": "A String", # [Custom label 1](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel2": "A String", # [Custom label 2](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel3": "A String", # [Custom label 3](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "customLabel4": "A String", # [Custom label 4](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+    "description": "A String", # Description of the item.
+    "disclosureDate": "A String", # The date time when an offer becomes visible in search results across Google’s YouTube surfaces, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. See [Disclosure date](https://support.google.com/merchants/answer/13034208) for more information.
+    "displayAdsId": "A String", # An identifier for an item for dynamic remarketing campaigns.
+    "displayAdsLink": "A String", # URL directly to your item's landing page for dynamic remarketing campaigns.
+    "displayAdsSimilarIds": [ # Advertiser-specified recommendations. For more information, see [Display ads attribute specification](https://support.google.com/merchants/answer/6069387).
+      "A String",
+    ],
+    "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](https://support.google.com/merchants/answer/7562785) 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.
+      "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.
+    "externalSellerId": "A String", # Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account.
+    "freeShippingThreshold": [ # Conditions to be met for a product to have free shipping.
+      { # Conditions to be met for a product to have free shipping.
+        "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+        "priceThreshold": { # The price represented as a number and currency. # The minimum product price for the shipping cost to become free. Represented as a number.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+      },
+    ],
+    "gender": "A String", # Target [gender](https://support.google.com/merchants/answer/6324479) of the item.
+    "googleProductCategory": "A String", # Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
+    "gtins": [ # Global Trade Item Numbers ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item. You can provide up to 10 GTINs.
+      "A String",
+    ],
+    "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.
+      "A String",
+    ],
+    "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per month.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "creditType": "A String", # Type of installment payments.
+      "downpayment": { # The price represented as a number and currency. # The up-front down payment amount the buyer has to pay.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "months": "A String", # The number of installments the buyer has to pay.
+    },
+    "isBundle": True or False, # Whether the item is a business-defined sub-API. A [sub-API] (https://support.google.com/merchants/answer/6324449) is a custom grouping of different products sold by a business for a single price.
+    "itemGroupId": "A String", # Shared identifier for all variants of the same product.
+    "lifestyleImageLinks": [ # Additional URLs of lifestyle images of the item, used to explicitly identify images that showcase your item in a real-world context. See the [Help Center article](https://support.google.com/merchants/answer/9103186) for more information.
+      "A String",
+    ],
+    "link": "A String", # URL directly linking to your item's page on your online store.
+    "linkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13871172) for business hosted local storefront.
+    "loyaltyPoints": { # A message that represents loyalty points. # Loyalty points that users receive after purchasing the item. Japan only.
+      "name": "A String", # Name of loyalty points program. It is recommended to limit the name to 12 full-width characters or 24 Roman characters.
+      "pointsValue": "A String", # The retailer's loyalty points in absolute value.
+      "ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.
+    },
+    "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item.
+      { # A message that represents loyalty program.
+        "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "loyaltyPoints": "A String", # The amount of loyalty points earned on a purchase.
+        "memberPriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # A date range during which the item is eligible for member price. If not specified, the member price is always applicable. The date range is represented by a pair of ISO 8601 dates separated by a space, comma, or slash.
+          "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+          "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+        },
+        "price": { # The price represented as a number and currency. # The price for members of the given tier, that is, the instant discount price. Must be smaller or equal to the regular price.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "programLabel": "A String", # The label of the loyalty program. This is an internal label that uniquely identifies the relationship between a business entity and a loyalty program entity. The label must be provided so that the system can associate the assets below (for example, price and points) with a business. The corresponding program must be linked to the Merchant Center account.
+        "shippingLabel": "A String", # The label of the shipping benefit. If the field has value, this offer has loyalty shipping benefit. If the field value isn't provided, the item is not eligible for loyalty shipping for the given loyalty tier.
+        "tierLabel": "A String", # The label of the tier within the loyalty program. Must match one of the labels within the program.
+      },
+    ],
+    "material": "A String", # The [material](https://support.google.com/merchants/answer/6324410) of which the item is made. For example, "Leather" or "Cotton".
+    "maxEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+    "maxHandlingTime": "A String", # Maximal product handling time (in business days).
+    "maximumRetailPrice": { # The price represented as a number and currency. # Maximum retail price (MRP) of the item. Applicable to India only.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "minEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+    "minHandlingTime": "A String", # Minimal product handling time (in business days).
+    "mobileLink": "A String", # URL for the mobile-optimized version of your item's landing page.
+    "mobileLinkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13870216) for business hosted local storefront optimized for mobile devices.
+    "mpn": "A String", # Manufacturer Part Number ([MPN](https://support.google.com/merchants/answer/188494#mpn)) of the item.
+    "multipack": "A String", # The number of identical products in a business-defined multipack.
+    "pattern": "A String", # The item's [pattern](https://support.google.com/merchants/answer/6324483). For example, polka dots.
+    "pause": "A String", # Publication of this item will be temporarily [paused](https://support.google.com/merchants/answer/11909930).
+    "pickupMethod": "A String", # The [pickup](https://support.google.com/merchants/answer/14634021) option for the item.
+    "pickupSla": "A String", # Item store pickup timeline. For more information, see [Pickup SLA](https://support.google.com/merchants/answer/14635400).
+    "price": { # The price represented as a number and currency. # Price of the item.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "productDetails": [ # Technical specification or additional product details.
+      { # The product details.
+        "attributeName": "A String", # The name of the product detail.
+        "attributeValue": "A String", # The value of the product detail.
+        "sectionName": "A String", # The section header used to group a set of product details.
+      },
+    ],
+    "productHeight": { # The dimension of the product. # The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "productHighlights": [ # Bullet points describing the most relevant [product highlights](https://support.google.com/merchants/answer/9216100).
+      "A String",
+    ],
+    "productLength": { # The dimension of the product. # The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "productTypes": [ # Categories of the item (formatted as in [product data specification](https://support.google.com/merchants/answer/7052112#product_category)).
+      "A String",
+    ],
+    "productWeight": { # The weight of the product. # The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).
+      "unit": "A String", # Required. The weight unit. Acceptable values are: * "`g`" * "`kg`" * "`oz`" * "`lb`"
+      "value": 3.14, # Required. The weight represented as a number. The weight can have a maximum precision of four decimal places.
+    },
+    "productWidth": { # The dimension of the product. # The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+      "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+      "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+    },
+    "promotionIds": [ # The unique ID of a promotion.
+      "A String",
+    ],
+    "salePrice": { # The price represented as a number and currency. # Advertised sale price of the item.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Date range during which the item is on sale, see [product data specification](https://support.google.com/merchants/answer/7052112#price_and_availability).
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+    "sellOnGoogleQuantity": "A String", # The quantity of the product that is available for selling on Google. Supported only for online products.
+    "shipping": [ # Shipping rules.
+      { # The Shipping of the product.
+        "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+        "locationGroupName": "A String", # The location where the shipping is applicable, represented by a location group name.
+        "locationId": "A String", # The numeric ID of a location that the shipping rate applies to as defined in the [AdWords API](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
+        "maxHandlingTime": "A String", # Maximum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minHandlingTime is optional if maxHandlingTime is present.
+        "maxTransitTime": "A String", # Maximum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minTransitTime is optional if maxTransitTime is present.
+        "minHandlingTime": "A String", # Minimum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. minHandlingTime can only be present together with maxHandlingTime; but it is not required if maxHandlingTime is present.
+        "minTransitTime": "A String", # Minimum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. minTransitTime can only be present together with maxTransitTime; but it is not required if maxTransitTime is present.
+        "postalCode": "A String", # The postal code range that the shipping rate applies to, represented by a postal code, a postal code prefix followed by a * wildcard, a range between two postal codes or two postal code prefixes of equal length.
+        "price": { # The price represented as a number and currency. # Fixed shipping price, represented as a number.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "region": "A String", # The geographic region to which a shipping rate applies. See [region](https://support.google.com/merchants/answer/6324484) for more information.
+        "service": "A String", # A free-form description of the service class or delivery speed.
+      },
+    ],
+    "shippingHeight": { # The ShippingDimension of the product. # Height of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shippingLabel": "A String", # The shipping label of the product, used to group product in account-level shipping rules.
+    "shippingLength": { # The ShippingDimension of the product. # Length of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shippingWeight": { # The ShippingWeight of the product. # Weight of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The weight of the product used to calculate the shipping cost of the item.
+    },
+    "shippingWidth": { # The ShippingDimension of the product. # Width of the item for shipping.
+      "unit": "A String", # The unit of value.
+      "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+    },
+    "shoppingAdsExcludedCountries": [ # List of country codes [(ISO 3166-1 alpha-2)](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in data source settings.
+      "A String",
+    ],
+    "size": "A String", # Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same `itemGroupId` value, see [Size](https://support.google.com/merchants/answer/6324492).
+    "sizeSystem": "A String", # System in which the size is specified. Recommended for apparel items. For more information, see [Size system](https://support.google.com/merchants/answer/6324502).
+    "sizeTypes": [ # The cut of the item. It can be used to represent combined size types for apparel items. Maximum two of size types can be provided, see [Size type](https://support.google.com/merchants/answer/6324497).
+      "A String",
+    ],
+    "structuredDescription": { # Structured description, for algorithmically (AI)-generated descriptions. # Structured description, for algorithmically (AI)-generated descriptions.
+      "content": "A String", # The description text Maximum length is 5000 characters
+      "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+    },
+    "structuredTitle": { # Structured title, for algorithmically (AI)-generated titles. # Structured title, for algorithmically (AI)-generated titles.
+      "content": "A String", # The title text Maximum length is 150 characters
+      "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+    },
+    "subscriptionCost": { # The SubscriptionCost of the product. # Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per subscription period.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "period": "A String", # The type of subscription period. Supported values are: * "`month`" * "`year`"
+      "periodLength": "A String", # The number of subscription periods the buyer has to pay.
+    },
+    "sustainabilityIncentives": [ # The list of sustainability incentive programs.
+      { # Information regarding sustainability-related incentive programs such as rebates or tax relief.
+        "amount": { # The price represented as a number and currency. # The fixed amount of the incentive.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "percentage": 3.14, # The percentage of the sale price that the incentive is applied to.
+        "type": "A String", # Sustainability incentive program.
+      },
+    ],
+    "title": "A String", # Title of the item.
+    "transitTimeLabel": "A String", # The transit time label of the product, used to group product in account-level transit time tables.
+    "unitPricingBaseMeasure": { # The UnitPricingBaseMeasure of the product. # The preference of the denominator of the unit price.
+      "unit": "A String", # The unit of the denominator.
+      "value": "A String", # The denominator of the unit price.
+    },
+    "unitPricingMeasure": { # The UnitPricingMeasure of the product. # The measure and dimension of an item.
+      "unit": "A String", # The unit of the measure.
+      "value": 3.14, # The measure of an item.
+    },
+    "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information.
+  },
+  "productStatus": { # The status of a product, data validation issues, that is, information about a product computed asynchronously. # Output only. The status of a product, data validation issues, that is, information about a product computed asynchronously.
+    "creationDate": "A String", # Date on which the item has been created, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+    "destinationStatuses": [ # The intended destinations for the product.
+      { # The destination status of the product status.
+        "approvedCountries": [ # List of country codes (ISO 3166-1 alpha-2) where the offer is approved.
+          "A String",
+        ],
+        "disapprovedCountries": [ # List of country codes (ISO 3166-1 alpha-2) where the offer is disapproved.
+          "A String",
+        ],
+        "pendingCountries": [ # List of country codes (ISO 3166-1 alpha-2) where the offer is pending approval.
+          "A String",
+        ],
+        "reportingContext": "A String", # The name of the reporting context.
+      },
+    ],
+    "googleExpirationDate": "A String", # Date on which the item expires, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+    "itemLevelIssues": [ # A list of all issues associated with the product.
+      { # The ItemLevelIssue of the product status.
+        "applicableCountries": [ # List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.
+          "A String",
+        ],
+        "attribute": "A String", # The attribute's name, if the issue is caused by a single attribute.
+        "code": "A String", # The error code of the issue.
+        "description": "A String", # A short issue description in English.
+        "detail": "A String", # A detailed issue description in English.
+        "documentation": "A String", # The URL of a web page to help with resolving this issue.
+        "reportingContext": "A String", # The reporting context the issue applies to.
+        "resolution": "A String", # Whether the issue can be resolved by the business.
+        "severity": "A String", # How this issue affects serving of the offer.
+      },
+    ],
+    "lastUpdateDate": "A String", # Date on which the item has been last updated, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+  },
+  "versionNumber": "A String", # Output only. Represents the existing version (freshness) of the product, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing product. Re-insertion (for example, product refresh after 30 days) can be performed with the current `version_number`. Only supported for insertions into primary data sources. If the operation is prevented, the aborted exception will be thrown.
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists the processed products in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested. After inserting, updating, or deleting a product input, it may take several minutes before the updated processed product can be retrieved.
+
+Args:
+  parent: string, Required. The account to list processed products for. Format: `accounts/{account}` (required)
+  pageSize: integer, The maximum number of products to return. The service may return fewer than this value. The maximum value is 1000; values above 1000 will be coerced to 1000. If unspecified, the default page size of 25 products will be returned.
+  pageToken: string, A page token, received from a previous `ListProducts` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListProducts` 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 the ListProducts method.
+  "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.
+  "products": [ # The processed products from the specified account. These are your processed products after applying rules and supplemental data sources.
+    { # The processed product, built from multiple product inputs after applying rules and supplemental data sources. This processed product matches what is shown in your Merchant Center account. Each product is built from exactly one primary data source product input, and multiple supplemental data source inputs. After inserting, updating, or deleting a product input, it may take several minutes before the updated processed product can be retrieved. All fields in the processed product and its sub-messages match the name of their corresponding attribute in the [Product data specification](https://support.google.com/merchants/answer/7052112) with some exceptions.
+      "automatedDiscounts": { # Information regarding Automated Discounts. # Output only. The automated discounts information for the product.
+        "gadPrice": { # The price represented as a number and currency. # The current sale price for products with a price optimized using Google Automated Discounts (GAD). Absent if the information about the GAD_price of the product is not available.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "priorPrice": { # The price represented as a number and currency. # The price prior to the application of the first price reduction. Absent if the information about the prior price of the product is not available.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "priorPriceProgressive": { # The price represented as a number and currency. # The price prior to the application of consecutive price reductions. Absent if the information about the prior price of the product is not available.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+      },
+      "contentLanguage": "A String", # Output only. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the product.
+      "customAttributes": [ # Output only. A list of custom (merchant-provided) attributes. It can also be used to submit any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" }`). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google.
+        { # A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.
+          "groupValues": [ # Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.
+            # Object with schema name: CustomAttribute
+          ],
+          "name": "A String", # The name of the attribute.
+          "value": "A String", # The value of the attribute. If `value` is not empty, `group_values` must be empty.
+        },
+      ],
+      "dataSource": "A String", # Output only. The primary data source of the product.
+      "feedLabel": "A String", # Output only. The feed label lets you categorize and identify your products. The maximum allowed characters is 20 and the supported characters are`A-Z`, `0-9`, hyphen and underscore. The feed label must not include any spaces. For more information, see [Using feed labels](//support.google.com/merchants/answer/14994087)
+      "legacyLocal": True or False, # Output only. Determines whether the product is **only** targeting local destinations and whether the product name should be distinguished with a `local~` prefix. For example, `accounts/123/products/local~en~US~sku123`.
+      "name": "A String", # The name of the product. Format: `accounts/{account}/products/{product}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/products/en~US~sku123`. A legacy local product name would be `accounts/123/products/local~en~US~sku123`. Note: For calls to the v1beta version, the `product` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/products/online~en~US~sku123`.
+      "offerId": "A String", # Output only. Your unique identifier for the product. This is the same for the product input and processed product. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. See the [product data specification](https://support.google.com/merchants/answer/188494#id) for details.
+      "productAttributes": { # Product attributes. # Output only. A list of strongly-typed product attributes.
+        "additionalImageLinks": [ # Additional URLs of images of the item.
+          "A String",
+        ],
+        "adsGrouping": "A String", # Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
+        "adsLabels": [ # Similar to ads_grouping, but only works on CPC.
+          "A String",
+        ],
+        "adsRedirect": "A String", # Allows advertisers to override the item URL when the product is shown within the context of Product ads.
+        "adult": True or False, # Set to true if the item is targeted towards adults.
+        "ageGroup": "A String", # Target [age group](https://support.google.com/merchants/answer/6324463) of the item.
+        "autoPricingMinPrice": { # The price represented as a number and currency. # A safeguard in the [automated discounts] (https://support.google.com/merchants/answer/10295759) and "Dynamic Promotions" (https://support.google.com/merchants/answer/13949249) projects, ensuring that discounts on business offers do not fall below this value, thereby preserving the offer's value and profitability.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "availability": "A String", # [Availability](https://support.google.com/merchants/answer/6324448) status of the item.
+        "availabilityDate": "A String", # The day a pre-ordered product becomes available for delivery, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+        "brand": "A String", # [Brand](https://support.google.com/merchants/answer/6324351) of the item. For example, "Google".
+        "canonicalLink": "A String", # URL for the canonical version of your item's landing page.
+        "certifications": [ # Product Certifications, for example for energy efficiency labeling of products recorded in the [EU EPREL](https://eprel.ec.europa.eu/screen/home) database. See the [Help Center](https://support.google.com/merchants/answer/13528839) article for more information.
+          { # Product [certification](https://support.google.com/merchants/answer/13528839), initially introduced for EU energy efficiency labeling compliance using the EU EPREL database.
+            "certificationAuthority": "A String", # The certification authority.
+            "certificationCode": "A String", # The certification code. Maximum length is 2000 characters.
+            "certificationName": "A String", # The name of the certification.
+            "certificationValue": "A String", # The certification value (also known as class, level or grade), for example "A+", "C", "gold". Maximum length is 2000 characters.
+          },
+        ],
+        "cloudExportAdditionalProperties": [ # Extra fields to export to the Cloud Retail program.
+          { # Product property for the Cloud Retail API. For example, properties for a TV product could be "Screen-Resolution" or "Screen-Size".
+            "boolValue": True or False, # Boolean value of the given property. For example for a TV product, "True" or "False" if the screen is UHD.
+            "floatValue": [ # Float values of the given property. For example for a TV product 1.2345. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+              3.14,
+            ],
+            "intValue": [ # Integer values of the given property. For example, 1080 for a TV product's Screen Resolution. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.
+              "A String",
+            ],
+            "maxValue": 3.14, # Maximum float value of the given property. For example for a TV product 100.00.
+            "minValue": 3.14, # Minimum float value of the given property. For example for a TV product 1.00.
+            "propertyName": "A String", # Name of the given property. For example, "Screen-Resolution" for a TV product. Maximum string size is 256 characters.
+            "textValue": [ # Text value of the given property. For example, "8K(UHD)" could be a text value for a TV product. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order. Maximum string size is 256 characters.
+              "A String",
+            ],
+            "unitCode": "A String", # Unit of the given property. For example, "Pixels" for a TV product. Maximum string size is 256B.
+          },
+        ],
+        "color": "A String", # [Color](https://support.google.com/merchants/answer/6324487) of the item. For example, "red".
+        "condition": "A String", # [Condition](https://support.google.com/merchants/answer/6324469) or state of the item.
+        "costOfGoodsSold": { # The price represented as a number and currency. # Cost of goods sold. Used for gross profit reporting.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "customLabel0": "A String", # [Custom label 0](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+        "customLabel1": "A String", # [Custom label 1](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+        "customLabel2": "A String", # [Custom label 2](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+        "customLabel3": "A String", # [Custom label 3](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+        "customLabel4": "A String", # [Custom label 4](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.
+        "description": "A String", # Description of the item.
+        "disclosureDate": "A String", # The date time when an offer becomes visible in search results across Google’s YouTube surfaces, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. See [Disclosure date](https://support.google.com/merchants/answer/13034208) for more information.
+        "displayAdsId": "A String", # An identifier for an item for dynamic remarketing campaigns.
+        "displayAdsLink": "A String", # URL directly to your item's landing page for dynamic remarketing campaigns.
+        "displayAdsSimilarIds": [ # Advertiser-specified recommendations. For more information, see [Display ads attribute specification](https://support.google.com/merchants/answer/6069387).
+          "A String",
+        ],
+        "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](https://support.google.com/merchants/answer/7562785) 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.
+          "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.
+        "externalSellerId": "A String", # Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account.
+        "freeShippingThreshold": [ # Conditions to be met for a product to have free shipping.
+          { # Conditions to be met for a product to have free shipping.
+            "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+            "priceThreshold": { # The price represented as a number and currency. # The minimum product price for the shipping cost to become free. Represented as a number.
+              "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+              "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+            },
+          },
+        ],
+        "gender": "A String", # Target [gender](https://support.google.com/merchants/answer/6324479) of the item.
+        "googleProductCategory": "A String", # Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
+        "gtins": [ # Global Trade Item Numbers ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item. You can provide up to 10 GTINs.
+          "A String",
+        ],
+        "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.
+          "A String",
+        ],
+        "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
+          "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per month.
+            "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+            "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+          },
+          "creditType": "A String", # Type of installment payments.
+          "downpayment": { # The price represented as a number and currency. # The up-front down payment amount the buyer has to pay.
+            "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+            "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+          },
+          "months": "A String", # The number of installments the buyer has to pay.
+        },
+        "isBundle": True or False, # Whether the item is a business-defined sub-API. A [sub-API] (https://support.google.com/merchants/answer/6324449) is a custom grouping of different products sold by a business for a single price.
+        "itemGroupId": "A String", # Shared identifier for all variants of the same product.
+        "lifestyleImageLinks": [ # Additional URLs of lifestyle images of the item, used to explicitly identify images that showcase your item in a real-world context. See the [Help Center article](https://support.google.com/merchants/answer/9103186) for more information.
+          "A String",
+        ],
+        "link": "A String", # URL directly linking to your item's page on your online store.
+        "linkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13871172) for business hosted local storefront.
+        "loyaltyPoints": { # A message that represents loyalty points. # Loyalty points that users receive after purchasing the item. Japan only.
+          "name": "A String", # Name of loyalty points program. It is recommended to limit the name to 12 full-width characters or 24 Roman characters.
+          "pointsValue": "A String", # The retailer's loyalty points in absolute value.
+          "ratio": 3.14, # The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.
+        },
+        "loyaltyPrograms": [ # A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item.
+          { # A message that represents loyalty program.
+            "cashbackForFutureUse": { # The price represented as a number and currency. # The cashback that can be used for future purchases.
+              "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+              "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+            },
+            "loyaltyPoints": "A String", # The amount of loyalty points earned on a purchase.
+            "memberPriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # A date range during which the item is eligible for member price. If not specified, the member price is always applicable. The date range is represented by a pair of ISO 8601 dates separated by a space, comma, or slash.
+              "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+              "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+            },
+            "price": { # The price represented as a number and currency. # The price for members of the given tier, that is, the instant discount price. Must be smaller or equal to the regular price.
+              "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+              "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+            },
+            "programLabel": "A String", # The label of the loyalty program. This is an internal label that uniquely identifies the relationship between a business entity and a loyalty program entity. The label must be provided so that the system can associate the assets below (for example, price and points) with a business. The corresponding program must be linked to the Merchant Center account.
+            "shippingLabel": "A String", # The label of the shipping benefit. If the field has value, this offer has loyalty shipping benefit. If the field value isn't provided, the item is not eligible for loyalty shipping for the given loyalty tier.
+            "tierLabel": "A String", # The label of the tier within the loyalty program. Must match one of the labels within the program.
+          },
+        ],
+        "material": "A String", # The [material](https://support.google.com/merchants/answer/6324410) of which the item is made. For example, "Leather" or "Cotton".
+        "maxEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+        "maxHandlingTime": "A String", # Maximal product handling time (in business days).
+        "maximumRetailPrice": { # The price represented as a number and currency. # Maximum retail price (MRP) of the item. Applicable to India only.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "minEnergyEfficiencyClass": "A String", # The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.
+        "minHandlingTime": "A String", # Minimal product handling time (in business days).
+        "mobileLink": "A String", # URL for the mobile-optimized version of your item's landing page.
+        "mobileLinkTemplate": "A String", # [Link template](https://support.google.com/merchants/answer/13870216) for business hosted local storefront optimized for mobile devices.
+        "mpn": "A String", # Manufacturer Part Number ([MPN](https://support.google.com/merchants/answer/188494#mpn)) of the item.
+        "multipack": "A String", # The number of identical products in a business-defined multipack.
+        "pattern": "A String", # The item's [pattern](https://support.google.com/merchants/answer/6324483). For example, polka dots.
+        "pause": "A String", # Publication of this item will be temporarily [paused](https://support.google.com/merchants/answer/11909930).
+        "pickupMethod": "A String", # The [pickup](https://support.google.com/merchants/answer/14634021) option for the item.
+        "pickupSla": "A String", # Item store pickup timeline. For more information, see [Pickup SLA](https://support.google.com/merchants/answer/14635400).
+        "price": { # The price represented as a number and currency. # Price of the item.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "productDetails": [ # Technical specification or additional product details.
+          { # The product details.
+            "attributeName": "A String", # The name of the product detail.
+            "attributeValue": "A String", # The value of the product detail.
+            "sectionName": "A String", # The section header used to group a set of product details.
+          },
+        ],
+        "productHeight": { # The dimension of the product. # The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+          "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+          "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+        },
+        "productHighlights": [ # Bullet points describing the most relevant [product highlights](https://support.google.com/merchants/answer/9216100).
+          "A String",
+        ],
+        "productLength": { # The dimension of the product. # The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+          "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+          "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+        },
+        "productTypes": [ # Categories of the item (formatted as in [product data specification](https://support.google.com/merchants/answer/7052112#product_category)).
+          "A String",
+        ],
+        "productWeight": { # The weight of the product. # The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).
+          "unit": "A String", # Required. The weight unit. Acceptable values are: * "`g`" * "`kg`" * "`oz`" * "`lb`"
+          "value": 3.14, # Required. The weight represented as a number. The weight can have a maximum precision of four decimal places.
+        },
+        "productWidth": { # The dimension of the product. # The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
+          "unit": "A String", # Required. The dimension units. Acceptable values are: * "`in`" * "`cm`"
+          "value": 3.14, # Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
+        },
+        "promotionIds": [ # The unique ID of a promotion.
+          "A String",
+        ],
+        "salePrice": { # The price represented as a number and currency. # Advertised sale price of the item.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "salePriceEffectiveDate": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Date range during which the item is on sale, see [product data specification](https://support.google.com/merchants/answer/7052112#price_and_availability).
+          "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+          "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+        },
+        "sellOnGoogleQuantity": "A String", # The quantity of the product that is available for selling on Google. Supported only for online products.
+        "shipping": [ # Shipping rules.
+          { # The Shipping of the product.
+            "country": "A String", # The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.
+            "locationGroupName": "A String", # The location where the shipping is applicable, represented by a location group name.
+            "locationId": "A String", # The numeric ID of a location that the shipping rate applies to as defined in the [AdWords API](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
+            "maxHandlingTime": "A String", # Maximum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minHandlingTime is optional if maxHandlingTime is present.
+            "maxTransitTime": "A String", # Maximum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minTransitTime is optional if maxTransitTime is present.
+            "minHandlingTime": "A String", # Minimum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. minHandlingTime can only be present together with maxHandlingTime; but it is not required if maxHandlingTime is present.
+            "minTransitTime": "A String", # Minimum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. minTransitTime can only be present together with maxTransitTime; but it is not required if maxTransitTime is present.
+            "postalCode": "A String", # The postal code range that the shipping rate applies to, represented by a postal code, a postal code prefix followed by a * wildcard, a range between two postal codes or two postal code prefixes of equal length.
+            "price": { # The price represented as a number and currency. # Fixed shipping price, represented as a number.
+              "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+              "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+            },
+            "region": "A String", # The geographic region to which a shipping rate applies. See [region](https://support.google.com/merchants/answer/6324484) for more information.
+            "service": "A String", # A free-form description of the service class or delivery speed.
+          },
+        ],
+        "shippingHeight": { # The ShippingDimension of the product. # Height of the item for shipping.
+          "unit": "A String", # The unit of value.
+          "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+        },
+        "shippingLabel": "A String", # The shipping label of the product, used to group product in account-level shipping rules.
+        "shippingLength": { # The ShippingDimension of the product. # Length of the item for shipping.
+          "unit": "A String", # The unit of value.
+          "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+        },
+        "shippingWeight": { # The ShippingWeight of the product. # Weight of the item for shipping.
+          "unit": "A String", # The unit of value.
+          "value": 3.14, # The weight of the product used to calculate the shipping cost of the item.
+        },
+        "shippingWidth": { # The ShippingDimension of the product. # Width of the item for shipping.
+          "unit": "A String", # The unit of value.
+          "value": 3.14, # The dimension of the product used to calculate the shipping cost of the item.
+        },
+        "shoppingAdsExcludedCountries": [ # List of country codes [(ISO 3166-1 alpha-2)](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in data source settings.
+          "A String",
+        ],
+        "size": "A String", # Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same `itemGroupId` value, see [Size](https://support.google.com/merchants/answer/6324492).
+        "sizeSystem": "A String", # System in which the size is specified. Recommended for apparel items. For more information, see [Size system](https://support.google.com/merchants/answer/6324502).
+        "sizeTypes": [ # The cut of the item. It can be used to represent combined size types for apparel items. Maximum two of size types can be provided, see [Size type](https://support.google.com/merchants/answer/6324497).
+          "A String",
+        ],
+        "structuredDescription": { # Structured description, for algorithmically (AI)-generated descriptions. # Structured description, for algorithmically (AI)-generated descriptions.
+          "content": "A String", # The description text Maximum length is 5000 characters
+          "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+        },
+        "structuredTitle": { # Structured title, for algorithmically (AI)-generated titles. # Structured title, for algorithmically (AI)-generated titles.
+          "content": "A String", # The title text Maximum length is 150 characters
+          "digitalSourceType": "A String", # The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).
+        },
+        "subscriptionCost": { # The SubscriptionCost of the product. # Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
+          "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per subscription period.
+            "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+            "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+          },
+          "period": "A String", # The type of subscription period. Supported values are: * "`month`" * "`year`"
+          "periodLength": "A String", # The number of subscription periods the buyer has to pay.
+        },
+        "sustainabilityIncentives": [ # The list of sustainability incentive programs.
+          { # Information regarding sustainability-related incentive programs such as rebates or tax relief.
+            "amount": { # The price represented as a number and currency. # The fixed amount of the incentive.
+              "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+              "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+            },
+            "percentage": 3.14, # The percentage of the sale price that the incentive is applied to.
+            "type": "A String", # Sustainability incentive program.
+          },
+        ],
+        "title": "A String", # Title of the item.
+        "transitTimeLabel": "A String", # The transit time label of the product, used to group product in account-level transit time tables.
+        "unitPricingBaseMeasure": { # The UnitPricingBaseMeasure of the product. # The preference of the denominator of the unit price.
+          "unit": "A String", # The unit of the denominator.
+          "value": "A String", # The denominator of the unit price.
+        },
+        "unitPricingMeasure": { # The UnitPricingMeasure of the product. # The measure and dimension of an item.
+          "unit": "A String", # The unit of the measure.
+          "value": 3.14, # The measure of an item.
+        },
+        "virtualModelLink": "A String", # URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information.
+      },
+      "productStatus": { # The status of a product, data validation issues, that is, information about a product computed asynchronously. # Output only. The status of a product, data validation issues, that is, information about a product computed asynchronously.
+        "creationDate": "A String", # Date on which the item has been created, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+        "destinationStatuses": [ # The intended destinations for the product.
+          { # The destination status of the product status.
+            "approvedCountries": [ # List of country codes (ISO 3166-1 alpha-2) where the offer is approved.
+              "A String",
+            ],
+            "disapprovedCountries": [ # List of country codes (ISO 3166-1 alpha-2) where the offer is disapproved.
+              "A String",
+            ],
+            "pendingCountries": [ # List of country codes (ISO 3166-1 alpha-2) where the offer is pending approval.
+              "A String",
+            ],
+            "reportingContext": "A String", # The name of the reporting context.
+          },
+        ],
+        "googleExpirationDate": "A String", # Date on which the item expires, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+        "itemLevelIssues": [ # A list of all issues associated with the product.
+          { # The ItemLevelIssue of the product status.
+            "applicableCountries": [ # List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.
+              "A String",
+            ],
+            "attribute": "A String", # The attribute's name, if the issue is caused by a single attribute.
+            "code": "A String", # The error code of the issue.
+            "description": "A String", # A short issue description in English.
+            "detail": "A String", # A detailed issue description in English.
+            "documentation": "A String", # The URL of a web page to help with resolving this issue.
+            "reportingContext": "A String", # The reporting context the issue applies to.
+            "resolution": "A String", # Whether the issue can be resolved by the business.
+            "severity": "A String", # How this issue affects serving of the offer.
+          },
+        ],
+        "lastUpdateDate": "A String", # Date on which the item has been last updated, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.
+      },
+      "versionNumber": "A String", # Output only. Represents the existing version (freshness) of the product, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing product. Re-insertion (for example, product refresh after 30 days) can be performed with the current `version_number`. Only supported for insertions into primary data sources. If the operation is prevented, the aborted exception will be thrown.
+    },
+  ],
+}

+

+
+

+    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/merchantapi_products_v1.html b/docs/dyn/merchantapi_products_v1.html
new file mode 100644
index 00000000000..9edbea5c282
--- /dev/null
+++ b/docs/dyn/merchantapi_products_v1.html
@@ -0,0 +1,111 @@
+
+
+
+
Merchant API

+
Instance Methods

+

+  accounts()
+

+
Returns the accounts Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  new_batch_http_request()

+
Create a BatchHttpRequest object based on the discovery document.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    new_batch_http_request()
+  
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_promotions_v1.accounts.html b/docs/dyn/merchantapi_promotions_v1.accounts.html
new file mode 100644
index 00000000000..87e9d6e5690
--- /dev/null
+++ b/docs/dyn/merchantapi_promotions_v1.accounts.html
@@ -0,0 +1,91 @@
+
+
+
+
Merchant API . accounts

+
Instance Methods

+

+  promotions()
+

+
Returns the promotions Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_promotions_v1.accounts.promotions.html b/docs/dyn/merchantapi_promotions_v1.accounts.promotions.html
new file mode 100644
index 00000000000..0583b37de4b
--- /dev/null
+++ b/docs/dyn/merchantapi_promotions_v1.accounts.promotions.html
@@ -0,0 +1,642 @@
+
+
+
+
Merchant API . accounts . promotions

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

+
Retrieves the promotion from your Merchant Center account. After inserting or updating a promotion input, it may take several minutes before the updated promotion can be retrieved.

+

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

+
Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead.

+

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

+
Lists the promotions in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested. After inserting or updating a promotion, it may take several minutes before the updated processed promotion can be retrieved.

+

+  list_next()

+
Retrieves the next page of results.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    get(name, x__xgafv=None)
+  
Retrieves the promotion from your Merchant Center account. After inserting or updating a promotion input, it may take several minutes before the updated promotion can be retrieved.
+
+Args:
+  name: string, Required. The name of the promotion to retrieve. Format: `accounts/{account}/promotions/{promotions}` (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 promotion. See the following articles for more details. Required promotion input attributes to pass data validation checks are primarily defined below: * [Promotions data specification](https://support.google.com/merchants/answer/2906014) * [Local promotions data specification](https://support.google.com/merchants/answer/10146130) After inserting, updating a promotion input, it may take several minutes before the final promotion can be retrieved.
+  "attributes": { # Attributes. # Optional. A list of promotion attributes.
+    "brandExclusion": [ # Optional. Product filter by [brand exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "brandInclusion": [ # Optional. Product filter by brand for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "couponValueType": "A String", # Required. The [coupon value type] (https://support.google.com/merchants/answer/13861986?ref_topic=13773355&sjid=17642868584668136159-NC) attribute to signal the type of promotion that you are running. Depending on type of the selected coupon value [some attributes are required](https://support.google.com/merchants/answer/6393006?ref_topic=7322920).
+    "freeGiftDescription": "A String", # Optional. [Free gift description](https://support.google.com/merchants/answer/13847245?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+    "freeGiftItemId": "A String", # Optional. [Free gift item ID](https://support.google.com/merchants/answer/13857152?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+    "freeGiftValue": { # The price represented as a number and currency. # Optional. [Free gift value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "genericRedemptionCode": "A String", # Optional. Generic redemption code for the promotion. To be used with the `offerType` field and must meet the [minimum requirements](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC).
+    "getThisQuantityDiscounted": "A String", # Optional. The number of items discounted in the promotion. The attribute is set when `couponValueType` is equal to `buy_m_get_n_money_off` or `buy_m_get_n_percent_off`.
+    "itemGroupIdExclusion": [ # Optional. Product filter by [item group ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC). The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC). exclusion for the promotion.
+      "A String",
+    ],
+    "itemGroupIdInclusion": [ # Optional. Product filter by item group ID for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability [product_applicability] attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "itemIdExclusion": [ # Optional. Product filter by [item ID exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "itemIdInclusion": [ # Optional. Product filter by [item ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "limitQuantity": "A String", # Optional. [Maximum purchase quantity](https://support.google.com/merchants/answer/13861564?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+    "limitValue": { # The price represented as a number and currency. # Optional. [Maximum product price](https://support.google.com/merchants/answer/2906014) for promotion.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "longTitle": "A String", # Required. [Long title](https://support.google.com/merchants/answer/13838102?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+    "minimumPurchaseAmount": { # The price represented as a number and currency. # Optional. [Minimum purchase amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "minimumPurchaseQuantity": "A String",
+    "moneyOffAmount": { # The price represented as a number and currency. # Optional. The [money off amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC) offered in the promotion.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "offerType": "A String", # Required. [Type](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC) of the promotion. Use this attribute to indicate whether or not customers need a coupon code to redeem your promotion.
+    "percentOff": "A String", # Optional. The [percentage discount](https://support.google.com/merchants/answer/13837404?sjid=17642868584668136159-NC) offered in the promotion.
+    "productApplicability": "A String", # Required. Applicability of the promotion to either all products or [only specific products](https://support.google.com/merchants/answer/6396257?ref_topic=6396150&sjid=17642868584668136159-NC).
+    "productTypeExclusion": [ # Optional. Product filter by [product type exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "productTypeInclusion": [ # Optional. Product filter by product type for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "promotionDestinations": [ # Required. The list of destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) where the promotion applies to. If you don't specify a destination by including a supported value in your data source, your promotion will display in Shopping ads and free listings by default. You may have previously submitted the following values as destinations for your products: Shopping Actions, Surfaces across Google, Local surfaces across Google. To represent these values use `FREE_LISTINGS`, `FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see [Promotion destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)
+      "A String",
+    ],
+    "promotionDisplayTimePeriod": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Optional. `TimePeriod` representation of the promotion's display dates. This attribute specifies the date and time frame when the promotion will be live on Google.com and Shopping ads. If the display time period for promotion `promotion_display_time_period` attribute is not specified, the promotion effective time period `promotion_effective_time_period` determines the date and time frame when the promotion will be live on Google.com and Shopping ads.
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+    "promotionEffectiveTimePeriod": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Required. `TimePeriod` representation of the promotion's effective dates. This attribute specifies that the promotion can be tested on your online store during this time period.
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+    "promotionUrl": "A String", # Optional. URL to the page on the merchant's site where the promotion shows. Local Inventory ads promotions throw an error if no `promotion_url` is included. URL is used to confirm that the promotion is valid and can be redeemed.
+    "storeApplicability": "A String", # Optional. Whether the promotion applies to [all stores, or only specified stores](https://support.google.com/merchants/answer/13857563?sjid=17642868584668136159-NC). Local Inventory ads promotions throw an error if no store applicability is included. An `INVALID_ARGUMENT` error is thrown if `store_applicability` is set to `ALL_STORES` and `store_codes_inclusion` or `score_code_exclusion` is set to a value.
+    "storeCodesExclusion": [ # Optional. [Store codes to exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The store filter attributes only applies when the `store_applicability` attribute is set to [specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "storeCodesInclusion": [ # Optional. [Store codes to include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The store filter attributes only applies when the `store_applicability` attribute is set to [specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC). Store code (the store ID from your Business Profile) of the physical store the product is sold in. See the [Local product inventory data specification](https://support.google.com/merchants/answer/3061342) for more information.
+      "A String",
+    ],
+  },
+  "contentLanguage": "A String", # Required. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the promotion. Promotions is only for [selected languages](https://support.google.com/merchants/answer/4588281?ref_topic=6396150&sjid=18314938579342094533-NC#option3&zippy=).
+  "customAttributes": [ # Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" }`). This is useful for submitting attributes not explicitly exposed by the API.
+    { # A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.
+      "groupValues": [ # Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.
+        # Object with schema name: CustomAttribute
+      ],
+      "name": "A String", # The name of the attribute.
+      "value": "A String", # The value of the attribute. If `value` is not empty, `group_values` must be empty.
+    },
+  ],
+  "dataSource": "A String", # Output only. The primary data source of the promotion.
+  "name": "A String", # Identifier. The name of the promotion. Format: `accounts/{account}/promotions/{promotion}`
+  "promotionId": "A String", # Required. The user provided promotion ID to uniquely identify the promotion. Follow [minimum requirements](https://support.google.com/merchants/answer/7050148?ref_topic=7322920&sjid=871860036916537104-NC#minimum_requirements) to prevent promotion disapprovals.
+  "promotionStatus": { # The status of the promotion. # Output only. The [status of a promotion](https://support.google.com/merchants/answer/3398326?ref_topic=7322924&sjid=5155774230887277618-NC), data validation issues, that is, information about a promotion computed asynchronously.
+    "creationDate": "A String", # Output only. Date on which the promotion has been created in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example `2020-01-02T09:00:00+01:00` or `2020-01-02T09:00:00Z`
+    "destinationStatuses": [ # Output only. The intended destinations for the promotion.
+      { # The status for the specified destination.
+        "reportingContext": "A String", # Output only. The name of the promotion destination.
+        "status": "A String", # Output only. The status for the specified destination.
+      },
+    ],
+    "itemLevelIssues": [ # Output only. A list of issues associated with the promotion.
+      { # The issue associated with the promotion.
+        "applicableCountries": [ # Output only. List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.
+          "A String",
+        ],
+        "attribute": "A String", # Output only. The attribute's name, if the issue is caused by a single attribute.
+        "code": "A String", # Output only. The error code of the issue.
+        "description": "A String", # Output only. A short issue description in English.
+        "detail": "A String", # Output only. A detailed issue description in English.
+        "documentation": "A String", # Output only. The URL of a web page to help with resolving this issue.
+        "reportingContext": "A String", # Output only. The destination the issue applies to.
+        "resolution": "A String", # Output only. Whether the issue can be resolved by the merchant.
+        "severity": "A String", # Output only. How this issue affects serving of the promotion.
+      },
+    ],
+    "lastUpdateDate": "A String", # Output only. Date on which the promotion status has been last updated in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example `2020-01-02T09:00:00+01:00` or `2020-01-02T09:00:00Z`
+  },
+  "redemptionChannel": [ # Required. [Redemption channel](https://support.google.com/merchants/answer/13837674?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. At least one channel is required.
+    "A String",
+  ],
+  "targetCountry": "A String", # Required. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected countries, [Free Listings and Shopping ads](https://support.google.com/merchants/answer/4588460) [Local Inventory ads](https://support.google.com/merchants/answer/10146326)
+  "versionNumber": "A String", # Optional. Represents the existing version (freshness) of the promotion, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing promotion. Re-insertion (for example, promotion refresh after 30 days) can be performed with the current `version_number`. If the operation is prevented, the aborted exception will be thrown.
+}

+

+
+

+    insert(parent, body=None, x__xgafv=None)
+  
Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead.
+
+Args:
+  parent: string, Required. The account where the promotion will be inserted. Format: accounts/{account} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the `InsertPromotion` method.
+  "dataSource": "A String", # Required. The data source of the [promotion](https://support.google.com/merchants/answer/6396268?sjid=5155774230887277618-NC) Format: `accounts/{account}/dataSources/{datasource}`.
+  "promotion": { # Represents a promotion. See the following articles for more details. Required promotion input attributes to pass data validation checks are primarily defined below: * [Promotions data specification](https://support.google.com/merchants/answer/2906014) * [Local promotions data specification](https://support.google.com/merchants/answer/10146130) After inserting, updating a promotion input, it may take several minutes before the final promotion can be retrieved. # Required. The promotion to insert.
+    "attributes": { # Attributes. # Optional. A list of promotion attributes.
+      "brandExclusion": [ # Optional. Product filter by [brand exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+        "A String",
+      ],
+      "brandInclusion": [ # Optional. Product filter by brand for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+        "A String",
+      ],
+      "couponValueType": "A String", # Required. The [coupon value type] (https://support.google.com/merchants/answer/13861986?ref_topic=13773355&sjid=17642868584668136159-NC) attribute to signal the type of promotion that you are running. Depending on type of the selected coupon value [some attributes are required](https://support.google.com/merchants/answer/6393006?ref_topic=7322920).
+      "freeGiftDescription": "A String", # Optional. [Free gift description](https://support.google.com/merchants/answer/13847245?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+      "freeGiftItemId": "A String", # Optional. [Free gift item ID](https://support.google.com/merchants/answer/13857152?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+      "freeGiftValue": { # The price represented as a number and currency. # Optional. [Free gift value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "genericRedemptionCode": "A String", # Optional. Generic redemption code for the promotion. To be used with the `offerType` field and must meet the [minimum requirements](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "getThisQuantityDiscounted": "A String", # Optional. The number of items discounted in the promotion. The attribute is set when `couponValueType` is equal to `buy_m_get_n_money_off` or `buy_m_get_n_percent_off`.
+      "itemGroupIdExclusion": [ # Optional. Product filter by [item group ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC). The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC). exclusion for the promotion.
+        "A String",
+      ],
+      "itemGroupIdInclusion": [ # Optional. Product filter by item group ID for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability [product_applicability] attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+        "A String",
+      ],
+      "itemIdExclusion": [ # Optional. Product filter by [item ID exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+        "A String",
+      ],
+      "itemIdInclusion": [ # Optional. Product filter by [item ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+        "A String",
+      ],
+      "limitQuantity": "A String", # Optional. [Maximum purchase quantity](https://support.google.com/merchants/answer/13861564?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+      "limitValue": { # The price represented as a number and currency. # Optional. [Maximum product price](https://support.google.com/merchants/answer/2906014) for promotion.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "longTitle": "A String", # Required. [Long title](https://support.google.com/merchants/answer/13838102?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+      "minimumPurchaseAmount": { # The price represented as a number and currency. # Optional. [Minimum purchase amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "minimumPurchaseQuantity": "A String",
+      "moneyOffAmount": { # The price represented as a number and currency. # Optional. The [money off amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC) offered in the promotion.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "offerType": "A String", # Required. [Type](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC) of the promotion. Use this attribute to indicate whether or not customers need a coupon code to redeem your promotion.
+      "percentOff": "A String", # Optional. The [percentage discount](https://support.google.com/merchants/answer/13837404?sjid=17642868584668136159-NC) offered in the promotion.
+      "productApplicability": "A String", # Required. Applicability of the promotion to either all products or [only specific products](https://support.google.com/merchants/answer/6396257?ref_topic=6396150&sjid=17642868584668136159-NC).
+      "productTypeExclusion": [ # Optional. Product filter by [product type exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+        "A String",
+      ],
+      "productTypeInclusion": [ # Optional. Product filter by product type for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+        "A String",
+      ],
+      "promotionDestinations": [ # Required. The list of destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) where the promotion applies to. If you don't specify a destination by including a supported value in your data source, your promotion will display in Shopping ads and free listings by default. You may have previously submitted the following values as destinations for your products: Shopping Actions, Surfaces across Google, Local surfaces across Google. To represent these values use `FREE_LISTINGS`, `FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see [Promotion destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)
+        "A String",
+      ],
+      "promotionDisplayTimePeriod": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Optional. `TimePeriod` representation of the promotion's display dates. This attribute specifies the date and time frame when the promotion will be live on Google.com and Shopping ads. If the display time period for promotion `promotion_display_time_period` attribute is not specified, the promotion effective time period `promotion_effective_time_period` determines the date and time frame when the promotion will be live on Google.com and Shopping ads.
+        "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+        "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+      },
+      "promotionEffectiveTimePeriod": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Required. `TimePeriod` representation of the promotion's effective dates. This attribute specifies that the promotion can be tested on your online store during this time period.
+        "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+        "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+      },
+      "promotionUrl": "A String", # Optional. URL to the page on the merchant's site where the promotion shows. Local Inventory ads promotions throw an error if no `promotion_url` is included. URL is used to confirm that the promotion is valid and can be redeemed.
+      "storeApplicability": "A String", # Optional. Whether the promotion applies to [all stores, or only specified stores](https://support.google.com/merchants/answer/13857563?sjid=17642868584668136159-NC). Local Inventory ads promotions throw an error if no store applicability is included. An `INVALID_ARGUMENT` error is thrown if `store_applicability` is set to `ALL_STORES` and `store_codes_inclusion` or `score_code_exclusion` is set to a value.
+      "storeCodesExclusion": [ # Optional. [Store codes to exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The store filter attributes only applies when the `store_applicability` attribute is set to [specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).
+        "A String",
+      ],
+      "storeCodesInclusion": [ # Optional. [Store codes to include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The store filter attributes only applies when the `store_applicability` attribute is set to [specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC). Store code (the store ID from your Business Profile) of the physical store the product is sold in. See the [Local product inventory data specification](https://support.google.com/merchants/answer/3061342) for more information.
+        "A String",
+      ],
+    },
+    "contentLanguage": "A String", # Required. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the promotion. Promotions is only for [selected languages](https://support.google.com/merchants/answer/4588281?ref_topic=6396150&sjid=18314938579342094533-NC#option3&zippy=).
+    "customAttributes": [ # Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" }`). This is useful for submitting attributes not explicitly exposed by the API.
+      { # A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.
+        "groupValues": [ # Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.
+          # Object with schema name: CustomAttribute
+        ],
+        "name": "A String", # The name of the attribute.
+        "value": "A String", # The value of the attribute. If `value` is not empty, `group_values` must be empty.
+      },
+    ],
+    "dataSource": "A String", # Output only. The primary data source of the promotion.
+    "name": "A String", # Identifier. The name of the promotion. Format: `accounts/{account}/promotions/{promotion}`
+    "promotionId": "A String", # Required. The user provided promotion ID to uniquely identify the promotion. Follow [minimum requirements](https://support.google.com/merchants/answer/7050148?ref_topic=7322920&sjid=871860036916537104-NC#minimum_requirements) to prevent promotion disapprovals.
+    "promotionStatus": { # The status of the promotion. # Output only. The [status of a promotion](https://support.google.com/merchants/answer/3398326?ref_topic=7322924&sjid=5155774230887277618-NC), data validation issues, that is, information about a promotion computed asynchronously.
+      "creationDate": "A String", # Output only. Date on which the promotion has been created in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example `2020-01-02T09:00:00+01:00` or `2020-01-02T09:00:00Z`
+      "destinationStatuses": [ # Output only. The intended destinations for the promotion.
+        { # The status for the specified destination.
+          "reportingContext": "A String", # Output only. The name of the promotion destination.
+          "status": "A String", # Output only. The status for the specified destination.
+        },
+      ],
+      "itemLevelIssues": [ # Output only. A list of issues associated with the promotion.
+        { # The issue associated with the promotion.
+          "applicableCountries": [ # Output only. List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.
+            "A String",
+          ],
+          "attribute": "A String", # Output only. The attribute's name, if the issue is caused by a single attribute.
+          "code": "A String", # Output only. The error code of the issue.
+          "description": "A String", # Output only. A short issue description in English.
+          "detail": "A String", # Output only. A detailed issue description in English.
+          "documentation": "A String", # Output only. The URL of a web page to help with resolving this issue.
+          "reportingContext": "A String", # Output only. The destination the issue applies to.
+          "resolution": "A String", # Output only. Whether the issue can be resolved by the merchant.
+          "severity": "A String", # Output only. How this issue affects serving of the promotion.
+        },
+      ],
+      "lastUpdateDate": "A String", # Output only. Date on which the promotion status has been last updated in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example `2020-01-02T09:00:00+01:00` or `2020-01-02T09:00:00Z`
+    },
+    "redemptionChannel": [ # Required. [Redemption channel](https://support.google.com/merchants/answer/13837674?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. At least one channel is required.
+      "A String",
+    ],
+    "targetCountry": "A String", # Required. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected countries, [Free Listings and Shopping ads](https://support.google.com/merchants/answer/4588460) [Local Inventory ads](https://support.google.com/merchants/answer/10146326)
+    "versionNumber": "A String", # Optional. Represents the existing version (freshness) of the promotion, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing promotion. Re-insertion (for example, promotion refresh after 30 days) can be performed with the current `version_number`. If the operation is prevented, the aborted exception will be thrown.
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a promotion. See the following articles for more details. Required promotion input attributes to pass data validation checks are primarily defined below: * [Promotions data specification](https://support.google.com/merchants/answer/2906014) * [Local promotions data specification](https://support.google.com/merchants/answer/10146130) After inserting, updating a promotion input, it may take several minutes before the final promotion can be retrieved.
+  "attributes": { # Attributes. # Optional. A list of promotion attributes.
+    "brandExclusion": [ # Optional. Product filter by [brand exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "brandInclusion": [ # Optional. Product filter by brand for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "couponValueType": "A String", # Required. The [coupon value type] (https://support.google.com/merchants/answer/13861986?ref_topic=13773355&sjid=17642868584668136159-NC) attribute to signal the type of promotion that you are running. Depending on type of the selected coupon value [some attributes are required](https://support.google.com/merchants/answer/6393006?ref_topic=7322920).
+    "freeGiftDescription": "A String", # Optional. [Free gift description](https://support.google.com/merchants/answer/13847245?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+    "freeGiftItemId": "A String", # Optional. [Free gift item ID](https://support.google.com/merchants/answer/13857152?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+    "freeGiftValue": { # The price represented as a number and currency. # Optional. [Free gift value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "genericRedemptionCode": "A String", # Optional. Generic redemption code for the promotion. To be used with the `offerType` field and must meet the [minimum requirements](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC).
+    "getThisQuantityDiscounted": "A String", # Optional. The number of items discounted in the promotion. The attribute is set when `couponValueType` is equal to `buy_m_get_n_money_off` or `buy_m_get_n_percent_off`.
+    "itemGroupIdExclusion": [ # Optional. Product filter by [item group ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC). The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC). exclusion for the promotion.
+      "A String",
+    ],
+    "itemGroupIdInclusion": [ # Optional. Product filter by item group ID for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability [product_applicability] attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "itemIdExclusion": [ # Optional. Product filter by [item ID exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "itemIdInclusion": [ # Optional. Product filter by [item ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "limitQuantity": "A String", # Optional. [Maximum purchase quantity](https://support.google.com/merchants/answer/13861564?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+    "limitValue": { # The price represented as a number and currency. # Optional. [Maximum product price](https://support.google.com/merchants/answer/2906014) for promotion.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "longTitle": "A String", # Required. [Long title](https://support.google.com/merchants/answer/13838102?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+    "minimumPurchaseAmount": { # The price represented as a number and currency. # Optional. [Minimum purchase amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "minimumPurchaseQuantity": "A String",
+    "moneyOffAmount": { # The price represented as a number and currency. # Optional. The [money off amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC) offered in the promotion.
+      "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+      "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+    },
+    "offerType": "A String", # Required. [Type](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC) of the promotion. Use this attribute to indicate whether or not customers need a coupon code to redeem your promotion.
+    "percentOff": "A String", # Optional. The [percentage discount](https://support.google.com/merchants/answer/13837404?sjid=17642868584668136159-NC) offered in the promotion.
+    "productApplicability": "A String", # Required. Applicability of the promotion to either all products or [only specific products](https://support.google.com/merchants/answer/6396257?ref_topic=6396150&sjid=17642868584668136159-NC).
+    "productTypeExclusion": [ # Optional. Product filter by [product type exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "productTypeInclusion": [ # Optional. Product filter by product type for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "promotionDestinations": [ # Required. The list of destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) where the promotion applies to. If you don't specify a destination by including a supported value in your data source, your promotion will display in Shopping ads and free listings by default. You may have previously submitted the following values as destinations for your products: Shopping Actions, Surfaces across Google, Local surfaces across Google. To represent these values use `FREE_LISTINGS`, `FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see [Promotion destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)
+      "A String",
+    ],
+    "promotionDisplayTimePeriod": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Optional. `TimePeriod` representation of the promotion's display dates. This attribute specifies the date and time frame when the promotion will be live on Google.com and Shopping ads. If the display time period for promotion `promotion_display_time_period` attribute is not specified, the promotion effective time period `promotion_effective_time_period` determines the date and time frame when the promotion will be live on Google.com and Shopping ads.
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+    "promotionEffectiveTimePeriod": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Required. `TimePeriod` representation of the promotion's effective dates. This attribute specifies that the promotion can be tested on your online store during this time period.
+      "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+      "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+    },
+    "promotionUrl": "A String", # Optional. URL to the page on the merchant's site where the promotion shows. Local Inventory ads promotions throw an error if no `promotion_url` is included. URL is used to confirm that the promotion is valid and can be redeemed.
+    "storeApplicability": "A String", # Optional. Whether the promotion applies to [all stores, or only specified stores](https://support.google.com/merchants/answer/13857563?sjid=17642868584668136159-NC). Local Inventory ads promotions throw an error if no store applicability is included. An `INVALID_ARGUMENT` error is thrown if `store_applicability` is set to `ALL_STORES` and `store_codes_inclusion` or `score_code_exclusion` is set to a value.
+    "storeCodesExclusion": [ # Optional. [Store codes to exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The store filter attributes only applies when the `store_applicability` attribute is set to [specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).
+      "A String",
+    ],
+    "storeCodesInclusion": [ # Optional. [Store codes to include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The store filter attributes only applies when the `store_applicability` attribute is set to [specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC). Store code (the store ID from your Business Profile) of the physical store the product is sold in. See the [Local product inventory data specification](https://support.google.com/merchants/answer/3061342) for more information.
+      "A String",
+    ],
+  },
+  "contentLanguage": "A String", # Required. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the promotion. Promotions is only for [selected languages](https://support.google.com/merchants/answer/4588281?ref_topic=6396150&sjid=18314938579342094533-NC#option3&zippy=).
+  "customAttributes": [ # Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" }`). This is useful for submitting attributes not explicitly exposed by the API.
+    { # A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.
+      "groupValues": [ # Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.
+        # Object with schema name: CustomAttribute
+      ],
+      "name": "A String", # The name of the attribute.
+      "value": "A String", # The value of the attribute. If `value` is not empty, `group_values` must be empty.
+    },
+  ],
+  "dataSource": "A String", # Output only. The primary data source of the promotion.
+  "name": "A String", # Identifier. The name of the promotion. Format: `accounts/{account}/promotions/{promotion}`
+  "promotionId": "A String", # Required. The user provided promotion ID to uniquely identify the promotion. Follow [minimum requirements](https://support.google.com/merchants/answer/7050148?ref_topic=7322920&sjid=871860036916537104-NC#minimum_requirements) to prevent promotion disapprovals.
+  "promotionStatus": { # The status of the promotion. # Output only. The [status of a promotion](https://support.google.com/merchants/answer/3398326?ref_topic=7322924&sjid=5155774230887277618-NC), data validation issues, that is, information about a promotion computed asynchronously.
+    "creationDate": "A String", # Output only. Date on which the promotion has been created in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example `2020-01-02T09:00:00+01:00` or `2020-01-02T09:00:00Z`
+    "destinationStatuses": [ # Output only. The intended destinations for the promotion.
+      { # The status for the specified destination.
+        "reportingContext": "A String", # Output only. The name of the promotion destination.
+        "status": "A String", # Output only. The status for the specified destination.
+      },
+    ],
+    "itemLevelIssues": [ # Output only. A list of issues associated with the promotion.
+      { # The issue associated with the promotion.
+        "applicableCountries": [ # Output only. List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.
+          "A String",
+        ],
+        "attribute": "A String", # Output only. The attribute's name, if the issue is caused by a single attribute.
+        "code": "A String", # Output only. The error code of the issue.
+        "description": "A String", # Output only. A short issue description in English.
+        "detail": "A String", # Output only. A detailed issue description in English.
+        "documentation": "A String", # Output only. The URL of a web page to help with resolving this issue.
+        "reportingContext": "A String", # Output only. The destination the issue applies to.
+        "resolution": "A String", # Output only. Whether the issue can be resolved by the merchant.
+        "severity": "A String", # Output only. How this issue affects serving of the promotion.
+      },
+    ],
+    "lastUpdateDate": "A String", # Output only. Date on which the promotion status has been last updated in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example `2020-01-02T09:00:00+01:00` or `2020-01-02T09:00:00Z`
+  },
+  "redemptionChannel": [ # Required. [Redemption channel](https://support.google.com/merchants/answer/13837674?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. At least one channel is required.
+    "A String",
+  ],
+  "targetCountry": "A String", # Required. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected countries, [Free Listings and Shopping ads](https://support.google.com/merchants/answer/4588460) [Local Inventory ads](https://support.google.com/merchants/answer/10146326)
+  "versionNumber": "A String", # Optional. Represents the existing version (freshness) of the promotion, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing promotion. Re-insertion (for example, promotion refresh after 30 days) can be performed with the current `version_number`. If the operation is prevented, the aborted exception will be thrown.
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists the promotions in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested. After inserting or updating a promotion, it may take several minutes before the updated processed promotion can be retrieved.
+
+Args:
+  parent: string, Required. The account to list processed promotions for. Format: `accounts/{account}` (required)
+  pageSize: integer, Optional. The maximum number of promotions to return. The service may return fewer than this value. The maximum value is 250; values above 250 will be coerced to 250. If unspecified, the maximum number of promotions will be returned.
+  pageToken: string, Optional. A page token, received from a previous `ListPromotions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPromotions` 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 the `ListPromotions` method.
+  "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.
+  "promotions": [ # The processed promotions from the specified account.
+    { # Represents a promotion. See the following articles for more details. Required promotion input attributes to pass data validation checks are primarily defined below: * [Promotions data specification](https://support.google.com/merchants/answer/2906014) * [Local promotions data specification](https://support.google.com/merchants/answer/10146130) After inserting, updating a promotion input, it may take several minutes before the final promotion can be retrieved.
+      "attributes": { # Attributes. # Optional. A list of promotion attributes.
+        "brandExclusion": [ # Optional. Product filter by [brand exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+          "A String",
+        ],
+        "brandInclusion": [ # Optional. Product filter by brand for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+          "A String",
+        ],
+        "couponValueType": "A String", # Required. The [coupon value type] (https://support.google.com/merchants/answer/13861986?ref_topic=13773355&sjid=17642868584668136159-NC) attribute to signal the type of promotion that you are running. Depending on type of the selected coupon value [some attributes are required](https://support.google.com/merchants/answer/6393006?ref_topic=7322920).
+        "freeGiftDescription": "A String", # Optional. [Free gift description](https://support.google.com/merchants/answer/13847245?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+        "freeGiftItemId": "A String", # Optional. [Free gift item ID](https://support.google.com/merchants/answer/13857152?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+        "freeGiftValue": { # The price represented as a number and currency. # Optional. [Free gift value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "genericRedemptionCode": "A String", # Optional. Generic redemption code for the promotion. To be used with the `offerType` field and must meet the [minimum requirements](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC).
+        "getThisQuantityDiscounted": "A String", # Optional. The number of items discounted in the promotion. The attribute is set when `couponValueType` is equal to `buy_m_get_n_money_off` or `buy_m_get_n_percent_off`.
+        "itemGroupIdExclusion": [ # Optional. Product filter by [item group ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC). The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC). exclusion for the promotion.
+          "A String",
+        ],
+        "itemGroupIdInclusion": [ # Optional. Product filter by item group ID for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability [product_applicability] attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+          "A String",
+        ],
+        "itemIdExclusion": [ # Optional. Product filter by [item ID exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+          "A String",
+        ],
+        "itemIdInclusion": [ # Optional. Product filter by [item ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+          "A String",
+        ],
+        "limitQuantity": "A String", # Optional. [Maximum purchase quantity](https://support.google.com/merchants/answer/13861564?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+        "limitValue": { # The price represented as a number and currency. # Optional. [Maximum product price](https://support.google.com/merchants/answer/2906014) for promotion.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "longTitle": "A String", # Required. [Long title](https://support.google.com/merchants/answer/13838102?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+        "minimumPurchaseAmount": { # The price represented as a number and currency. # Optional. [Minimum purchase amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "minimumPurchaseQuantity": "A String",
+        "moneyOffAmount": { # The price represented as a number and currency. # Optional. The [money off amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC) offered in the promotion.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "offerType": "A String", # Required. [Type](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC) of the promotion. Use this attribute to indicate whether or not customers need a coupon code to redeem your promotion.
+        "percentOff": "A String", # Optional. The [percentage discount](https://support.google.com/merchants/answer/13837404?sjid=17642868584668136159-NC) offered in the promotion.
+        "productApplicability": "A String", # Required. Applicability of the promotion to either all products or [only specific products](https://support.google.com/merchants/answer/6396257?ref_topic=6396150&sjid=17642868584668136159-NC).
+        "productTypeExclusion": [ # Optional. Product filter by [product type exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+          "A String",
+        ],
+        "productTypeInclusion": [ # Optional. Product filter by product type for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
+          "A String",
+        ],
+        "promotionDestinations": [ # Required. The list of destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) where the promotion applies to. If you don't specify a destination by including a supported value in your data source, your promotion will display in Shopping ads and free listings by default. You may have previously submitted the following values as destinations for your products: Shopping Actions, Surfaces across Google, Local surfaces across Google. To represent these values use `FREE_LISTINGS`, `FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see [Promotion destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)
+          "A String",
+        ],
+        "promotionDisplayTimePeriod": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Optional. `TimePeriod` representation of the promotion's display dates. This attribute specifies the date and time frame when the promotion will be live on Google.com and Shopping ads. If the display time period for promotion `promotion_display_time_period` attribute is not specified, the promotion effective time period `promotion_effective_time_period` determines the date and time frame when the promotion will be live on Google.com and Shopping ads.
+          "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+          "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+        },
+        "promotionEffectiveTimePeriod": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Required. `TimePeriod` representation of the promotion's effective dates. This attribute specifies that the promotion can be tested on your online store during this time period.
+          "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
+          "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
+        },
+        "promotionUrl": "A String", # Optional. URL to the page on the merchant's site where the promotion shows. Local Inventory ads promotions throw an error if no `promotion_url` is included. URL is used to confirm that the promotion is valid and can be redeemed.
+        "storeApplicability": "A String", # Optional. Whether the promotion applies to [all stores, or only specified stores](https://support.google.com/merchants/answer/13857563?sjid=17642868584668136159-NC). Local Inventory ads promotions throw an error if no store applicability is included. An `INVALID_ARGUMENT` error is thrown if `store_applicability` is set to `ALL_STORES` and `store_codes_inclusion` or `score_code_exclusion` is set to a value.
+        "storeCodesExclusion": [ # Optional. [Store codes to exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The store filter attributes only applies when the `store_applicability` attribute is set to [specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).
+          "A String",
+        ],
+        "storeCodesInclusion": [ # Optional. [Store codes to include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The store filter attributes only applies when the `store_applicability` attribute is set to [specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC). Store code (the store ID from your Business Profile) of the physical store the product is sold in. See the [Local product inventory data specification](https://support.google.com/merchants/answer/3061342) for more information.
+          "A String",
+        ],
+      },
+      "contentLanguage": "A String", # Required. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the promotion. Promotions is only for [selected languages](https://support.google.com/merchants/answer/4588281?ref_topic=6396150&sjid=18314938579342094533-NC#option3&zippy=).
+      "customAttributes": [ # Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" }`). This is useful for submitting attributes not explicitly exposed by the API.
+        { # A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.
+          "groupValues": [ # Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.
+            # Object with schema name: CustomAttribute
+          ],
+          "name": "A String", # The name of the attribute.
+          "value": "A String", # The value of the attribute. If `value` is not empty, `group_values` must be empty.
+        },
+      ],
+      "dataSource": "A String", # Output only. The primary data source of the promotion.
+      "name": "A String", # Identifier. The name of the promotion. Format: `accounts/{account}/promotions/{promotion}`
+      "promotionId": "A String", # Required. The user provided promotion ID to uniquely identify the promotion. Follow [minimum requirements](https://support.google.com/merchants/answer/7050148?ref_topic=7322920&sjid=871860036916537104-NC#minimum_requirements) to prevent promotion disapprovals.
+      "promotionStatus": { # The status of the promotion. # Output only. The [status of a promotion](https://support.google.com/merchants/answer/3398326?ref_topic=7322924&sjid=5155774230887277618-NC), data validation issues, that is, information about a promotion computed asynchronously.
+        "creationDate": "A String", # Output only. Date on which the promotion has been created in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example `2020-01-02T09:00:00+01:00` or `2020-01-02T09:00:00Z`
+        "destinationStatuses": [ # Output only. The intended destinations for the promotion.
+          { # The status for the specified destination.
+            "reportingContext": "A String", # Output only. The name of the promotion destination.
+            "status": "A String", # Output only. The status for the specified destination.
+          },
+        ],
+        "itemLevelIssues": [ # Output only. A list of issues associated with the promotion.
+          { # The issue associated with the promotion.
+            "applicableCountries": [ # Output only. List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.
+              "A String",
+            ],
+            "attribute": "A String", # Output only. The attribute's name, if the issue is caused by a single attribute.
+            "code": "A String", # Output only. The error code of the issue.
+            "description": "A String", # Output only. A short issue description in English.
+            "detail": "A String", # Output only. A detailed issue description in English.
+            "documentation": "A String", # Output only. The URL of a web page to help with resolving this issue.
+            "reportingContext": "A String", # Output only. The destination the issue applies to.
+            "resolution": "A String", # Output only. Whether the issue can be resolved by the merchant.
+            "severity": "A String", # Output only. How this issue affects serving of the promotion.
+          },
+        ],
+        "lastUpdateDate": "A String", # Output only. Date on which the promotion status has been last updated in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example `2020-01-02T09:00:00+01:00` or `2020-01-02T09:00:00Z`
+      },
+      "redemptionChannel": [ # Required. [Redemption channel](https://support.google.com/merchants/answer/13837674?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. At least one channel is required.
+        "A String",
+      ],
+      "targetCountry": "A String", # Required. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected countries, [Free Listings and Shopping ads](https://support.google.com/merchants/answer/4588460) [Local Inventory ads](https://support.google.com/merchants/answer/10146326)
+      "versionNumber": "A String", # Optional. Represents the existing version (freshness) of the promotion, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing promotion. Re-insertion (for example, promotion refresh after 30 days) can be performed with the current `version_number`. If the operation is prevented, the aborted exception will be thrown.
+    },
+  ],
+}

+

+
+

+    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/merchantapi_promotions_v1.html b/docs/dyn/merchantapi_promotions_v1.html
new file mode 100644
index 00000000000..6d8f15a188b
--- /dev/null
+++ b/docs/dyn/merchantapi_promotions_v1.html
@@ -0,0 +1,111 @@
+
+
+
+
Merchant API

+
Instance Methods

+

+  accounts()
+

+
Returns the accounts Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  new_batch_http_request()

+
Create a BatchHttpRequest object based on the discovery document.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    new_batch_http_request()
+  
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_promotions_v1beta.accounts.promotions.html b/docs/dyn/merchantapi_promotions_v1beta.accounts.promotions.html
index 56f10d7a1a5..4d22c0012b0 100644
--- a/docs/dyn/merchantapi_promotions_v1beta.accounts.promotions.html
+++ b/docs/dyn/merchantapi_promotions_v1beta.accounts.promotions.html
@@ -491,8 +491,8 @@ 
Method Details

 
 Args:
   parent: string, Required. The account to list processed promotions for. Format: `accounts/{account}` (required)
-  pageSize: integer, Output only. The maximum number of promotions to return. The service may return fewer than this value. The maximum value is 250; values above 250 will be coerced to 250. If unspecified, the maximum number of promotions will be returned.
-  pageToken: string, Output only. A page token, received from a previous `ListPromotions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPromotions` must match the call that provided the page token.
+  pageSize: integer, Optional. The maximum number of promotions to return. The service may return fewer than this value. The maximum value is 250; values above 250 will be coerced to 250. If unspecified, the maximum number of promotions will be returned.
+  pageToken: string, Optional. A page token, received from a previous `ListPromotions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPromotions` must match the call that provided the page token.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/merchantapi_quota_v1.accounts.html b/docs/dyn/merchantapi_quota_v1.accounts.html
new file mode 100644
index 00000000000..21a026be2c8
--- /dev/null
+++ b/docs/dyn/merchantapi_quota_v1.accounts.html
@@ -0,0 +1,91 @@
+
+
+
+
Merchant API . accounts

+
Instance Methods

+

+  quotas()
+

+
Returns the quotas Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_quota_v1.accounts.quotas.html b/docs/dyn/merchantapi_quota_v1.accounts.quotas.html
new file mode 100644
index 00000000000..c44e40cebf2
--- /dev/null
+++ b/docs/dyn/merchantapi_quota_v1.accounts.quotas.html
@@ -0,0 +1,143 @@
+
+
+
+
Merchant API . accounts . quotas

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Lists the daily call quota and usage per group for your Merchant Center account.

+

+  list_next()

+
Retrieves the next page of results.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists the daily call quota and usage per group for your Merchant Center account.
+
+Args:
+  parent: string, Required. The merchant account who owns the collection of method quotas Format: accounts/{account} (required)
+  pageSize: integer, Optional. The maximum number of quotas to return in the response, used for paging. Defaults to 500; values above 1000 will be coerced to 1000.
+  pageToken: string, Optional. Token (if provided) to retrieve the subsequent page. All other parameters must match the original 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 the ListMethodGroups method.
+  "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.
+  "quotaGroups": [ # The methods, current quota usage and limits per each group. The quota is shared between all methods in the group. The groups are sorted in descending order based on quota_usage.
+    { # The group information for methods in the Merchant API. The quota is shared between all methods in the group. Even if none of the methods within the group have usage the information for the group is returned.
+      "methodDetails": [ # Output only. List of all methods group quota applies to.
+        { # The method details per method in the Merchant API.
+          "method": "A String", # Output only. The name of the method for example `products.list`.
+          "path": "A String", # Output only. The path for the method such as `products/v1/productInputs.insert`
+          "subapi": "A String", # Output only. The sub-API that the method belongs to.
+          "version": "A String", # Output only. The API version that the method belongs to.
+        },
+      ],
+      "name": "A String", # Identifier. The resource name of the quota group. Format: accounts/{account}/quotas/{group} Note: There is no guarantee on the format of {group}
+      "quotaLimit": "A String", # Output only. The maximum number of calls allowed per day for the group.
+      "quotaMinuteLimit": "A String", # Output only. The maximum number of calls allowed per minute for the group.
+      "quotaUsage": "A String", # Output only. The current quota usage, meaning the number of calls already made on a given day to the methods in the group. The daily quota limits reset at at 12:00 PM midday UTC.
+    },
+  ],
+}

+

+
+

+    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/merchantapi_quota_v1.html b/docs/dyn/merchantapi_quota_v1.html
new file mode 100644
index 00000000000..c6e2b7b53ce
--- /dev/null
+++ b/docs/dyn/merchantapi_quota_v1.html
@@ -0,0 +1,111 @@
+
+
+
+
Merchant API

+
Instance Methods

+

+  accounts()
+

+
Returns the accounts Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  new_batch_http_request()

+
Create a BatchHttpRequest object based on the discovery document.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    new_batch_http_request()
+  
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_reports_v1.accounts.html b/docs/dyn/merchantapi_reports_v1.accounts.html
new file mode 100644
index 00000000000..2ccb0db0512
--- /dev/null
+++ b/docs/dyn/merchantapi_reports_v1.accounts.html
@@ -0,0 +1,91 @@
+
+
+
+
Merchant API . accounts

+
Instance Methods

+

+  reports()
+

+
Returns the reports Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_reports_v1.accounts.reports.html b/docs/dyn/merchantapi_reports_v1.accounts.reports.html
new file mode 100644
index 00000000000..d8b2983f82a
--- /dev/null
+++ b/docs/dyn/merchantapi_reports_v1.accounts.reports.html
@@ -0,0 +1,398 @@
+
+
+
+
Merchant API . accounts . reports

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Retrieves a report defined by a search query. The response might contain fewer rows than specified by `page_size`. Rely on `next_page_token` to determine if there are more rows to be requested.

+

+  search_next()

+
Retrieves the next page of results.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    search(parent, body=None, x__xgafv=None)
+  
Retrieves a report defined by a search query. The response might contain fewer rows than specified by `page_size`. Rely on `next_page_token` to determine if there are more rows to be requested.
+
+Args:
+  parent: string, Required. Id of the account making the call. Must be a standalone account or an MCA subaccount. Format: accounts/{account} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the `ReportService.Search` method.
+  "pageSize": 42, # Optional. Number of `ReportRows` to retrieve in a single page. Defaults to 1000. Values above 5000 are coerced to 5000.
+  "pageToken": "A String", # Optional. Token of the page to retrieve. If not specified, the first page of results is returned. In order to request the next page of results, the value obtained from `next_page_token` in the previous response should be used.
+  "query": "A String", # Required. Query that defines a report to be retrieved. For details on how to construct your query, see the [Query Language guide](/merchant/api/guides/reports/query-language). For the full list of available tables and fields, see the [Available fields](/merchant/api/reference/rest/reports_v1beta/accounts.reports).
+}
+
+  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 `ReportService.Search` method.
+  "nextPageToken": "A String", # Token which can be sent as `page_token` to retrieve the next page. If omitted, there are no subsequent pages.
+  "results": [ # Rows that matched the search query.
+    { # Result row returned from the search query. Only the message corresponding to the queried table is populated in the response. Within the populated message, only the fields requested explicitly in the query are populated.
+      "bestSellersBrandView": { # Fields available for query in `best_sellers_brand_view` table. [Best sellers](https://support.google.com/merchants/answer/9488679) report with top brands. Values are only set for fields requested explicitly in the request's search query. # Fields available for query in `best_sellers_brand_view` table.
+        "brand": "A String", # Name of the brand.
+        "previousRank": "A String", # Popularity rank in the previous week or month.
+        "previousRelativeDemand": "A String", # Estimated demand in relation to the brand with the highest popularity rank in the same category and country in the previous week or month.
+        "rank": "A String", # Popularity of the brand on Ads and organic surfaces, in the selected category and country, based on the estimated number of units sold.
+        "relativeDemand": "A String", # Estimated demand in relation to the brand with the highest popularity rank in the same category and country.
+        "relativeDemandChange": "A String", # Change in the estimated demand. Whether it rose, sank or remained flat.
+        "reportCategoryId": "A String", # Google product category ID to calculate the ranking for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. If a `WHERE` condition on `report_category_id` is not specified in the query, rankings for all top-level categories are returned.
+        "reportCountryCode": "A String", # Country where the ranking is calculated. Represented in the ISO 3166 format. Required in the `SELECT` clause. Condition on `report_country_code` is required in the `WHERE` clause.
+        "reportDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Report date. The value of this field can only be one of the following: * The first day of the week (Monday) for weekly reports, * The first day of the month for monthly reports. Required in the `SELECT` clause. If a `WHERE` condition on `report_date` is not specified in the query, the latest available weekly or monthly report is returned.
+          "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+          "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+          "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+        },
+        "reportGranularity": "A String", # Granularity of the report. The ranking can be done over a week or a month timeframe. Required in the `SELECT` clause. Condition on `report_granularity` is required in the `WHERE` clause.
+      },
+      "bestSellersProductClusterView": { # Fields available for query in `best_sellers_product_cluster_view` table. [Best sellers](https://support.google.com/merchants/answer/9488679) report with top product clusters. A product cluster is a grouping for different offers and variants that represent the same product, for example, Google Pixel 7. Values are only set for fields requested explicitly in the request's search query. # Fields available for query in `best_sellers_product_cluster_view` table.
+        "brand": "A String", # Brand of the product cluster.
+        "brandInventoryStatus": "A String", # Whether there is at least one product of the brand currently `IN_STOCK` in your product data source in at least one of the countries, all products are `OUT_OF_STOCK` in your product data source in all countries, or `NOT_IN_INVENTORY`. The field doesn't take the Best sellers report country filter into account.
+        "categoryL1": "A String", # Product category (1st level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL2": "A String", # Product category (2nd level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL3": "A String", # Product category (3rd level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL4": "A String", # Product category (4th level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL5": "A String", # Product category (5th level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "inventoryStatus": "A String", # Whether the product cluster is `IN_STOCK` in your product data source in at least one of the countries, `OUT_OF_STOCK` in your product data source in all countries, or `NOT_IN_INVENTORY` at all. The field doesn't take the Best sellers report country filter into account.
+        "previousRank": "A String", # Popularity rank in the previous week or month.
+        "previousRelativeDemand": "A String", # Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country in the previous week or month.
+        "rank": "A String", # Popularity of the product cluster on Ads and organic surfaces, in the selected category and country, based on the estimated number of units sold.
+        "relativeDemand": "A String", # Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country.
+        "relativeDemandChange": "A String", # Change in the estimated demand. Whether it rose, sank or remained flat.
+        "reportCategoryId": "A String", # Google product category ID to calculate the ranking for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. If a `WHERE` condition on `report_category_id` is not specified in the query, rankings for all top-level categories are returned.
+        "reportCountryCode": "A String", # Country where the ranking is calculated. Represented in the ISO 3166 format. Required in the `SELECT` clause. Condition on `report_country_code` is required in the `WHERE` clause.
+        "reportDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Report date. The value of this field can only be one of the following: * The first day of the week (Monday) for weekly reports, * The first day of the month for monthly reports. Required in the `SELECT` clause. If a `WHERE` condition on `report_date` is not specified in the query, the latest available weekly or monthly report is returned.
+          "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+          "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+          "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+        },
+        "reportGranularity": "A String", # Granularity of the report. The ranking can be done over a week or a month timeframe. Required in the `SELECT` clause. Condition on `report_granularity` is required in the `WHERE` clause.
+        "title": "A String", # Title of the product cluster.
+        "variantGtins": [ # GTINs of example variants of the product cluster.
+          "A String",
+        ],
+      },
+      "competitiveVisibilityBenchmarkView": { # Fields available for query in `competitive_visibility_benchmark_view` table. [Competitive visibility](https://support.google.com/merchants/answer/11366442) report with the category benchmark. Values are only set for fields requested explicitly in the request's search query. # Fields available for query in `competitive_visibility_benchmark_view` table.
+        "categoryBenchmarkVisibilityTrend": 3.14, # Change in visibility based on impressions with respect to the start of the selected time range (or first day with non-zero impressions) for a combined set of merchants with highest visibility approximating the market. Cannot be filtered on in the 'WHERE' clause.
+        "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Date of this row. Required in the `SELECT` clause. A condition on `date` is required in the `WHERE` clause.
+          "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+          "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+          "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+        },
+        "reportCategoryId": "A String", # Google product category ID to calculate the report for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. A condition on `report_category_id` is required in the `WHERE` clause.
+        "reportCountryCode": "A String", # Country where impressions appeared. Required in the `SELECT` clause. A condition on `report_country_code` is required in the `WHERE` clause.
+        "trafficSource": "A String", # Traffic source of impressions. Required in the `SELECT` clause.
+        "yourDomainVisibilityTrend": 3.14, # Change in visibility based on impressions for your domain with respect to the start of the selected time range (or first day with non-zero impressions). Cannot be filtered on in the 'WHERE' clause.
+      },
+      "competitiveVisibilityCompetitorView": { # Fields available for query in `competitive_visibility_competitor_view` table. [Competitive visibility](https://support.google.com/merchants/answer/11366442) report with businesses with similar visibility. Values are only set for fields requested explicitly in the request's search query. # Fields available for query in `competitive_visibility_competitor_view` table.
+        "adsOrganicRatio": 3.14, # [Ads / organic ratio] (https://support.google.com/merchants/answer/11366442#zippy=%2Cads-free-ratio) shows how often the domain receives impressions from Shopping ads compared to organic traffic. The number is rounded and bucketed. Cannot be filtered on in the 'WHERE' clause.
+        "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Date of this row. A condition on `date` is required in the `WHERE` clause.
+          "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+          "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+          "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+        },
+        "domain": "A String", # Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.
+        "higherPositionRate": 3.14, # [Higher position rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Chigher-position-rate) shows how often a competitor’s offer got placed in a higher position on the page than your offer. Cannot be filtered on in the 'WHERE' clause.
+        "isYourDomain": True or False, # True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause.
+        "pageOverlapRate": 3.14, # [Page overlap rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Cpage-overlap-rate) shows how frequently competing retailers’ offers are shown together with your offers on the same page. Cannot be filtered on in the 'WHERE' clause.
+        "rank": "A String", # Position of the domain in the similar businesses ranking for the selected keys (`date`, `report_category_id`, `report_country_code`, `traffic_source`) based on impressions. 1 is the highest. Cannot be filtered on in the 'WHERE' clause.
+        "relativeVisibility": 3.14, # [Relative visibility] (https://support.google.com/merchants/answer/11366442#zippy=%2Crelative-visibility) shows how often your competitors’ offers are shown compared to your offers. In other words, this is the number of displayed impressions of a competitor retailer divided by the number of your displayed impressions during a selected time range for a selected product category and country. Cannot be filtered on in the 'WHERE' clause.
+        "reportCategoryId": "A String", # Google product category ID to calculate the report for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. A condition on `report_category_id` is required in the `WHERE` clause.
+        "reportCountryCode": "A String", # Country where impressions appeared. Required in the `SELECT` clause. A condition on `report_country_code` is required in the `WHERE` clause.
+        "trafficSource": "A String", # Traffic source of impressions. Required in the `SELECT` clause.
+      },
+      "competitiveVisibilityTopMerchantView": { # Fields available for query in `competitive_visibility_top_merchant_view` table. [Competitive visibility](https://support.google.com/merchants/answer/11366442) report with business with highest visibility. Values are only set for fields requested explicitly in the request's search query. # Fields available for query in `competitive_visibility_top_merchant_view` table.
+        "adsOrganicRatio": 3.14, # [Ads / organic ratio] (https://support.google.com/merchants/answer/11366442#zippy=%2Cads-free-ratio) shows how often the domain receives impressions from Shopping ads compared to organic traffic. The number is rounded and bucketed. Cannot be filtered on in the 'WHERE' clause.
+        "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Date of this row. Cannot be selected in the `SELECT` clause. A condition on `date` is required in the `WHERE` clause.
+          "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+          "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+          "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+        },
+        "domain": "A String", # Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.
+        "higherPositionRate": 3.14, # [Higher position rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Chigher-position-rate) shows how often a competitor’s offer got placed in a higher position on the page than your offer. Cannot be filtered on in the 'WHERE' clause.
+        "isYourDomain": True or False, # True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause.
+        "pageOverlapRate": 3.14, # [Page overlap rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Cpage-overlap-rate) shows how frequently competing retailers’ offers are shown together with your offers on the same page. Cannot be filtered on in the 'WHERE' clause.
+        "rank": "A String", # Position of the domain in the top merchants ranking for the selected keys (`date`, `report_category_id`, `report_country_code`, `traffic_source`) based on impressions. 1 is the highest. Cannot be filtered on in the 'WHERE' clause.
+        "reportCategoryId": "A String", # Google product category ID to calculate the report for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. A condition on `report_category_id` is required in the `WHERE` clause.
+        "reportCountryCode": "A String", # Country where impressions appeared. Required in the `SELECT` clause. A condition on `report_country_code` is required in the `WHERE` clause.
+        "trafficSource": "A String", # Traffic source of impressions. Required in the `SELECT` clause.
+      },
+      "nonProductPerformanceView": { # Fields available for query in `non_product_performance_view` table. Performance data on images and online store links leading to your non-product pages. This includes performance metrics (for example, `clicks`) and dimensions according to which performance metrics are segmented (for example, `date`). Segment fields cannot be selected in queries without also selecting at least one metric field. Values are only set for fields requested explicitly in the request's search query. # Fields available for query in `non_product_performance_view` table.
+        "clickThroughRate": 3.14, # Click-through rate - the number of clicks (`clicks`) divided by the number of impressions (`impressions`) of images and online store links leading to your non-product pages. Metric.
+        "clicks": "A String", # Number of clicks on images and online store links leading to your non-product pages. Metric.
+        "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Date in the merchant timezone to which metrics apply. Segment. Condition on `date` is required in the `WHERE` clause.
+          "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+          "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+          "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+        },
+        "impressions": "A String", # Number of times images and online store links leading to your non-product pages were shown. Metric.
+        "week": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # First day of the week (Monday) of the metrics date in the merchant timezone. Segment.
+          "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+          "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+          "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+        },
+      },
+      "priceCompetitivenessProductView": { # Fields available for query in `price_competitiveness_product_view` table. [Price competitiveness](https://support.google.com/merchants/answer/9626903) report. Values are only set for fields requested explicitly in the request's search query. # Fields available for query in `price_competitiveness_product_view` table.
+        "benchmarkPrice": { # The price represented as a number and currency. # Latest available price benchmark for the product's catalog in the benchmark country.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "brand": "A String", # Brand of the product.
+        "categoryL1": "A String", # Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL2": "A String", # Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL3": "A String", # Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL4": "A String", # Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL5": "A String", # Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "id": "A String", # REST ID of the product, in the form of `channel~languageCode~feedLabel~offerId`. Can be used to join data with the `product_view` table. Required in the `SELECT` clause.
+        "offerId": "A String", # Merchant-provided id of the product.
+        "price": { # The price represented as a number and currency. # Current price of the product.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "productTypeL1": "A String", # Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL2": "A String", # Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL3": "A String", # Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL4": "A String", # Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL5": "A String", # Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "reportCountryCode": "A String", # Country of the price benchmark. Represented in the ISO 3166 format. Required in the `SELECT` clause.
+        "title": "A String", # Title of the product.
+      },
+      "priceInsightsProductView": { # Fields available for query in `price_insights_product_view` table. [Price insights](https://support.google.com/merchants/answer/11916926) report. Values are only set for fields requested explicitly in the request's search query. # Fields available for query in `price_insights_product_view` table.
+        "brand": "A String", # Brand of the product.
+        "categoryL1": "A String", # Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL2": "A String", # Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL3": "A String", # Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL4": "A String", # Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL5": "A String", # Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "effectiveness": "A String", # The predicted effectiveness of applying the price suggestion, bucketed.
+        "id": "A String", # REST ID of the product, in the form of `channel~languageCode~feedLabel~offerId`. Can be used to join data with the `product_view` table. Required in the `SELECT` clause.
+        "offerId": "A String", # Merchant-provided id of the product.
+        "predictedClicksChangeFraction": 3.14, # Predicted change in clicks as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in clicks.
+        "predictedConversionsChangeFraction": 3.14, # Predicted change in conversions as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in conversions).
+        "predictedImpressionsChangeFraction": 3.14, # Predicted change in impressions as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in impressions.
+        "price": { # The price represented as a number and currency. # Current price of the product.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "productTypeL1": "A String", # Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL2": "A String", # Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL3": "A String", # Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL4": "A String", # Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL5": "A String", # Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "suggestedPrice": { # The price represented as a number and currency. # Latest suggested price for the product.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "title": "A String", # Title of the product.
+      },
+      "productPerformanceView": { # Fields available for query in `product_performance_view` table. Product performance data for your account, including performance metrics (for example, `clicks`) and dimensions according to which performance metrics are segmented (for example, `offer_id`). Values of product dimensions, such as `offer_id`, reflect the state of a product at the time of the impression. Segment fields cannot be selected in queries without also selecting at least one metric field. Values are only set for fields requested explicitly in the request's search query. # Fields available for query in `product_performance_view` table.
+        "brand": "A String", # Brand of the product. Segment.
+        "categoryL1": "A String", # [Product category (1st level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment.
+        "categoryL2": "A String", # [Product category (2nd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment.
+        "categoryL3": "A String", # [Product category (3rd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment.
+        "categoryL4": "A String", # [Product category (4th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment.
+        "categoryL5": "A String", # [Product category (5th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment.
+        "clickThroughRate": 3.14, # Click-through rate - the number of clicks merchant's products receive (clicks) divided by the number of times the products are shown (impressions). Metric.
+        "clicks": "A String", # Number of clicks. Metric.
+        "conversionRate": 3.14, # Number of conversions divided by the number of clicks, reported on the impression date. Metric. Available only for the `FREE` traffic source.
+        "conversionValue": { # The price represented as a number and currency. # Value of conversions attributed to the product, reported on the conversion date. Metric. Available only for the `FREE` traffic source.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "conversions": 3.14, # Number of conversions attributed to the product, reported on the conversion date. Depending on the attribution model, a conversion might be distributed across multiple clicks, where each click gets its own credit assigned. This metric is a sum of all such credits. Metric. Available only for the `FREE` traffic source.
+        "customLabel0": "A String", # Custom label 0 for custom grouping of products. Segment.
+        "customLabel1": "A String", # Custom label 1 for custom grouping of products. Segment.
+        "customLabel2": "A String", # Custom label 2 for custom grouping of products. Segment.
+        "customLabel3": "A String", # Custom label 3 for custom grouping of products. Segment.
+        "customLabel4": "A String", # Custom label 4 for custom grouping of products. Segment.
+        "customerCountryCode": "A String", # Code of the country where the customer is located at the time of the event. Represented in the ISO 3166 format. Segment. If the customer country cannot be determined, a special 'ZZ' code is returned.
+        "date": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Date in the merchant timezone to which metrics apply. Segment. Condition on `date` is required in the `WHERE` clause.
+          "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+          "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+          "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+        },
+        "impressions": "A String", # Number of times merchant's products are shown. Metric.
+        "marketingMethod": "A String", # Marketing method to which metrics apply. Segment.
+        "offerId": "A String", # Merchant-provided id of the product. Segment.
+        "productTypeL1": "A String", # [Product type (1st level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment.
+        "productTypeL2": "A String", # [Product type (2nd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment.
+        "productTypeL3": "A String", # [Product type (3rd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment.
+        "productTypeL4": "A String", # [Product type (4th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment.
+        "productTypeL5": "A String", # [Product type (5th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment.
+        "title": "A String", # Title of the product. Segment.
+        "week": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # First day of the week (Monday) of the metrics date in the merchant timezone. Segment.
+          "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+          "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+          "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+        },
+      },
+      "productView": { # Fields available for query in `product_view` table. Products in the current inventory. Products in this table are the same as in Products sub-API but not all product attributes from Products sub-API are available for query in this table. In contrast to Products sub-API, this table allows to filter the returned list of products by product attributes. To retrieve a single product by `id` or list all products, Products sub-API should be used. Values are only set for fields requested explicitly in the request's search query. # Fields available for query in `product_view` table.
+        "aggregatedReportingContextStatus": "A String", # Aggregated status.
+        "availability": "A String", # [Availability](https://support.google.com/merchants/answer/6324448) of the product.
+        "brand": "A String", # Brand of the product.
+        "categoryL1": "A String", # Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL2": "A String", # Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL3": "A String", # Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL4": "A String", # Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "categoryL5": "A String", # Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).
+        "channel": "A String", # Channel of the product. Can be `ONLINE` or `LOCAL`.
+        "clickPotential": "A String", # Estimated performance potential compared to highest performing products of the merchant.
+        "clickPotentialRank": "A String", # Rank of the product based on its click potential. A product with `click_potential_rank` 1 has the highest click potential among the merchant's products that fulfill the search query conditions.
+        "condition": "A String", # [Condition](https://support.google.com/merchants/answer/6324469) of the product.
+        "creationTime": "A String", # The time the merchant created the product in timestamp seconds.
+        "expirationDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Expiration date for the product, specified on insertion.
+          "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+          "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+          "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+        },
+        "feedLabel": "A String", # Feed label of the product.
+        "gtin": [ # List of Global Trade Item Numbers (GTINs) of the product.
+          "A String",
+        ],
+        "id": "A String", # REST ID of the product, in the form of `channel~languageCode~feedLabel~offerId`. Merchant API methods that operate on products take this as their `name` parameter. Required in the `SELECT` clause.
+        "itemGroupId": "A String", # Item group id provided by the merchant for grouping variants together.
+        "itemIssues": [ # List of item issues for the product. **This field cannot be used for sorting the results.** **Only selected attributes of this field (for example, `item_issues.severity.aggregated_severity`) can be used for filtering the results.**
+          { # Item issue associated with the product.
+            "resolution": "A String", # Item issue resolution.
+            "severity": { # How the issue affects the serving of the product. # Item issue severity.
+              "aggregatedSeverity": "A String", # Aggregated severity of the issue for all reporting contexts it affects. **This field can be used for filtering the results.**
+              "severityPerReportingContext": [ # Issue severity per reporting context.
+                { # Issue severity per reporting context.
+                  "demotedCountries": [ # List of demoted countries in the reporting context, represented in ISO 3166 format.
+                    "A String",
+                  ],
+                  "disapprovedCountries": [ # List of disapproved countries in the reporting context, represented in ISO 3166 format.
+                    "A String",
+                  ],
+                  "reportingContext": "A String", # Reporting context the issue applies to.
+                },
+              ],
+            },
+            "type": { # Issue type. # Item issue type.
+              "canonicalAttribute": "A String", # Canonical attribute name for attribute-specific issues.
+              "code": "A String", # Error code of the issue, equivalent to the `code` of [Product issues](https://developers.google.com/shopping-content/guides/product-issues).
+            },
+          },
+        ],
+        "languageCode": "A String", # Language code of the product in BCP 47 format.
+        "offerId": "A String", # Merchant-provided id of the product.
+        "price": { # The price represented as a number and currency. # Product price. Absent if the information about the price of the product is not available.
+          "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+          "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+        },
+        "productTypeL1": "A String", # Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL2": "A String", # Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL3": "A String", # Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL4": "A String", # Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "productTypeL5": "A String", # Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).
+        "shippingLabel": "A String", # Normalized [shipping label](https://support.google.com/merchants/answer/6324504) specified in the data source.
+        "thumbnailLink": "A String", # Link to the processed image of the product, hosted on the Google infrastructure.
+        "title": "A String", # Title of the product.
+      },
+    },
+  ],
+}

+

+
+

+    search_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/merchantapi_reports_v1.html b/docs/dyn/merchantapi_reports_v1.html
new file mode 100644
index 00000000000..bf2aefd9155
--- /dev/null
+++ b/docs/dyn/merchantapi_reports_v1.html
@@ -0,0 +1,111 @@
+
+
+
+
Merchant API

+
Instance Methods

+

+  accounts()
+

+
Returns the accounts Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  new_batch_http_request()

+
Create a BatchHttpRequest object based on the discovery document.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    new_batch_http_request()
+  
Create a BatchHttpRequest object based on the discovery document.
+
+                Args:
+                  callback: callable, A callback to be called for each response, of the
+                    form callback(id, response, exception). The first parameter is the
+                    request id, and the second is the deserialized response object. The
+                    third is an apiclient.errors.HttpError exception object if an HTTP
+                    error occurred while processing the request, or None if no error
+                    occurred.
+
+                Returns:
+                  A BatchHttpRequest object based on the discovery document.
+                

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_reports_v1beta.accounts.reports.html b/docs/dyn/merchantapi_reports_v1beta.accounts.reports.html
index 9450790748b..cbb01f745c9 100644
--- a/docs/dyn/merchantapi_reports_v1beta.accounts.reports.html
+++ b/docs/dyn/merchantapi_reports_v1beta.accounts.reports.html
@@ -101,7 +101,7 @@ 
Method Details

 { # Request message for the `ReportService.Search` method.
   "pageSize": 42, # Optional. Number of `ReportRows` to retrieve in a single page. Defaults to 1000. Values above 5000 are coerced to 5000.
   "pageToken": "A String", # Optional. Token of the page to retrieve. If not specified, the first page of results is returned. In order to request the next page of results, the value obtained from `next_page_token` in the previous response should be used.
-  "query": "A String", # Required. Query that defines a report to be retrieved. For details on how to construct your query, see the [Query Language guide](/merchant/api/guides/reports/query-language). For the full list of available tables and fields, see the [Available fields](/merchant/api/reference/rest/reports_v1beta/accounts.reports).
+  "query": "A String", # Required. Query that defines a report to be retrieved. For details on how to construct your query, see the [Query Language guide](/merchant/api/guides/reports/query-language). For the full list of available tables and fields, see the [Available fields](/merchant/api/reference/rest/reports_{api_version}/accounts.reports).
 }
 
   x__xgafv: string, V1 error format.
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1.json
new file mode 100644
index 00000000000..b2c536bb51b
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1.json
@@ -0,0 +1,5402 @@
+{
+"auth": {
+"oauth2": {
+"scopes": {
+"https://www.googleapis.com/auth/content": {
+"description": "Manage your product listings and accounts for Google Shopping"
+}
+}
+}
+},
+"basePath": "",
+"baseUrl": "https://merchantapi.googleapis.com/",
+"batchPath": "batch",
+"canonicalName": "Merchant",
+"description": "Programmatically manage your Merchant Center Accounts.",
+"discoveryVersion": "v1",
+"documentationLink": "https://developers.google.com/merchant/api",
+"fullyEncodeReservedExpansion": true,
+"icons": {
+"x16": "http://www.google.com/images/icons/product/search-16.gif",
+"x32": "http://www.google.com/images/icons/product/search-32.gif"
+},
+"id": "merchantapi:accounts_v1",
+"kind": "discovery#restDescription",
+"mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/",
+"name": "merchantapi",
+"ownerDomain": "google.com",
+"ownerName": "Google",
+"parameters": {
+"$.xgafv": {
+"description": "V1 error format.",
+"enum": [
+"1",
+"2"
+],
+"enumDescriptions": [
+"v1 error format",
+"v2 error format"
+],
+"location": "query",
+"type": "string"
+},
+"access_token": {
+"description": "OAuth access token.",
+"location": "query",
+"type": "string"
+},
+"alt": {
+"default": "json",
+"description": "Data format for response.",
+"enum": [
+"json",
+"media",
+"proto"
+],
+"enumDescriptions": [
+"Responses with Content-Type of application/json",
+"Media download with context-dependent Content-Type",
+"Responses with Content-Type of application/x-protobuf"
+],
+"location": "query",
+"type": "string"
+},
+"callback": {
+"description": "JSONP",
+"location": "query",
+"type": "string"
+},
+"fields": {
+"description": "Selector specifying which fields to include in a partial response.",
+"location": "query",
+"type": "string"
+},
+"key": {
+"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+"location": "query",
+"type": "string"
+},
+"oauth_token": {
+"description": "OAuth 2.0 token for the current user.",
+"location": "query",
+"type": "string"
+},
+"prettyPrint": {
+"default": "true",
+"description": "Returns response with indentations and line breaks.",
+"location": "query",
+"type": "boolean"
+},
+"quotaUser": {
+"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+"location": "query",
+"type": "string"
+},
+"uploadType": {
+"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+"location": "query",
+"type": "string"
+},
+"upload_protocol": {
+"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+"location": "query",
+"type": "string"
+}
+},
+"protocol": "rest",
+"resources": {
+"accounts": {
+"methods": {
+"createAndConfigure": {
+"description": "Creates a Merchant Center account with additional configuration. Adds the user that makes the request as an admin for the new account.",
+"flatPath": "accounts/v1/accounts:createAndConfigure",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.createAndConfigure",
+"parameterOrder": [],
+"parameters": {},
+"path": "accounts/v1/accounts:createAndConfigure",
+"request": {
+"$ref": "CreateAndConfigureAccountRequest"
+},
+"response": {
+"$ref": "Account"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"delete": {
+"description": "Deletes the specified account regardless of its type: standalone, advanced account or sub-account. Deleting an advanced account leads to the deletion of all of its sub-accounts. Executing this method requires admin access. The deletion succeeds only if the account does not provide services to any other account and has no processed offers. You can use the `force` parameter to override this.",
+"flatPath": "accounts/v1/accounts/{accountsId}",
+"httpMethod": "DELETE",
+"id": "merchantapi.accounts.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"force": {
+"description": "Optional. If set to `true`, the account is deleted even if it provides services to other accounts or has processed offers.",
+"location": "query",
+"type": "boolean"
+},
+"name": {
+"description": "Required. The name of the account to delete. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Retrieves an account from your Merchant Center account. After inserting, updating, or deleting an account, it may take several minutes before changes take effect.",
+"flatPath": "accounts/v1/accounts/{accountsId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the account to retrieve. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "Account"
+},
+"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/v1/accounts",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.list",
+"parameterOrder": [],
+"parameters": {
+"filter": {
+"description": "Optional. Returns only accounts that match the [filter](https://developers.google.com/merchant/api/guides/accounts/filter). For more details, see the [filter syntax reference](https://developers.google.com/merchant/api/guides/accounts/filter-syntax).",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Optional. The maximum number of accounts to return. The service may return fewer than this value. If unspecified, at most 250 accounts are returned. The maximum value is 500; values above 500 are coerced to 500.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `accounts.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided in the `accounts.list` request must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/accounts",
+"response": {
+"$ref": "ListAccountsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"listSubaccounts": {
+"description": "List all sub-accounts for a given advanced account. This is a convenience wrapper for the more powerful `accounts.list` method. This method will produce the same results as calling `ListsAccounts` with the following filter: `relationship(providerId={parent} AND service(type=\"ACCOUNT_AGGREGATION\"))`",
+"flatPath": "accounts/v1/accounts/{accountsId}:listSubaccounts",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.listSubaccounts",
+"parameterOrder": [
+"provider"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of accounts to return. The service may return fewer than this value. If unspecified, at most 250 accounts are returned. The maximum value is 500; values above 500 are coerced to 500.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `accounts.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided in the `accounts.list` request must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"provider": {
+"description": "Required. The aggregation service provider. Format: `accounts/{accountId}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+provider}:listSubaccounts",
+"response": {
+"$ref": "ListSubAccountsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"patch": {
+"description": "Updates an account regardless of its type: standalone, advanced account or sub-account. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the account. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `account_name` - `adult_content` - `language_code` - `time_zone`",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "Account"
+},
+"response": {
+"$ref": "Account"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+},
+"resources": {
+"autofeedSettings": {
+"methods": {
+"getAutofeedSettings": {
+"description": "Retrieves the autofeed settings of an account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/autofeedSettings",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.autofeedSettings.getAutofeedSettings",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`",
+"location": "path",
+"pattern": "^accounts/[^/]+/autofeedSettings$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "AutofeedSettings"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"updateAutofeedSettings": {
+"description": "Updates the autofeed settings of an account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/autofeedSettings",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.autofeedSettings.updateAutofeedSettings",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/autofeedSettings$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Required. List of fields being updated.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "AutofeedSettings"
+},
+"response": {
+"$ref": "AutofeedSettings"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"automaticImprovements": {
+"methods": {
+"getAutomaticImprovements": {
+"description": "Retrieves the automatic improvements of an account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/automaticImprovements",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.automaticImprovements.getAutomaticImprovements",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the automatic improvements. Format: `accounts/{account}/automaticImprovements`",
+"location": "path",
+"pattern": "^accounts/[^/]+/automaticImprovements$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "AutomaticImprovements"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"updateAutomaticImprovements": {
+"description": "Updates the automatic improvements of an account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/automaticImprovements",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.automaticImprovements.updateAutomaticImprovements",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the automatic improvements. Format: `accounts/{account}/automaticImprovements`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/automaticImprovements$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Required. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `item_updates` - `item_updates.account_level_settings` - `image_improvements` - `image_improvements.account_level_settings` - `shipping_improvements` - `shipping_improvements.allow_shipping_improvements`",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "AutomaticImprovements"
+},
+"response": {
+"$ref": "AutomaticImprovements"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"businessIdentity": {
+"methods": {
+"getBusinessIdentity": {
+"description": "Retrieves the business identity of an account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/businessIdentity",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.businessIdentity.getBusinessIdentity",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the business identity. Format: `accounts/{account}/businessIdentity`. For example, `accounts/123456/businessIdentity`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/businessIdentity$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "BusinessIdentity"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"updateBusinessIdentity": {
+"description": "Updates the business identity of an account. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}/businessIdentity",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.businessIdentity.updateBusinessIdentity",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the business identity. Format: `accounts/{account}/businessIdentity`",
+"location": "path",
+"pattern": "^accounts/[^/]+/businessIdentity$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `black_owned` - `latino_owned` - `promotions_consent` - `small_business` - `veteran_owned` - `women_owned`",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "BusinessIdentity"
+},
+"response": {
+"$ref": "BusinessIdentity"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"businessInfo": {
+"methods": {
+"getBusinessInfo": {
+"description": "Retrieves the business info of an account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/businessInfo",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.businessInfo.getBusinessInfo",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the business info. Format: `accounts/{account}/businessInfo`. For example, `accounts/123456/businessInfo`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/businessInfo$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "BusinessInfo"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"updateBusinessInfo": {
+"description": "Updates the business info of an account. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}/businessInfo",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.businessInfo.updateBusinessInfo",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the business info. Format: `accounts/{account}/businessInfo`",
+"location": "path",
+"pattern": "^accounts/[^/]+/businessInfo$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `address` - `customer_service` - `korean_business_registration_number`",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "BusinessInfo"
+},
+"response": {
+"$ref": "BusinessInfo"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"developerRegistration": {
+"methods": {
+"getDeveloperRegistration": {
+"description": "Retrieves a developer registration for a merchant.",
+"flatPath": "accounts/v1/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/v1/{+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/v1/accounts/{accountsId}/developerRegistration:registerGcp",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.developerRegistration.registerGcp",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the developer registration to be created for the merchant account that the GCP will be registered with. Format: `accounts/{account}/developerRegistration`",
+"location": "path",
+"pattern": "^accounts/[^/]+/developerRegistration$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}:registerGcp",
+"request": {
+"$ref": "RegisterGcpRequest"
+},
+"response": {
+"$ref": "DeveloperRegistration"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"unregisterGcp": {
+"description": "Unregister the calling GCP from the calling shopping account. Note that the GCP will still be able to access the API for at most 1 day from the unregister succussful call.",
+"flatPath": "accounts/v1/accounts/{accountsId}/developerRegistration:unregisterGcp",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.developerRegistration.unregisterGcp",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the developer registration to be created for the merchant account that the GCP will be registered with. Format: `accounts/{account}/developerRegistration`",
+"location": "path",
+"pattern": "^accounts/[^/]+/developerRegistration$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}:unregisterGcp",
+"request": {
+"$ref": "UnregisterGcpRequest"
+},
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"emailPreferences": {
+"methods": {
+"getEmailPreferences": {
+"description": "Returns the email preferences for a Merchant Center account user. This service only permits retrieving and updating email preferences for the authenticated user. Use the name=accounts/*/users/me/emailPreferences alias to get preferences for the authenticated user.",
+"flatPath": "accounts/v1/accounts/{accountsId}/users/{usersId}/emailPreferences",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.emailPreferences.getEmailPreferences",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the `EmailPreferences` resource. Format: `accounts/{account}/users/{email}/emailPreferences`",
+"location": "path",
+"pattern": "^accounts/[^/]+/users/[^/]+/emailPreferences$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "EmailPreferences"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"updateEmailPreferences": {
+"description": "Updates the email preferences for a Merchant Center account user. Advanced account users should specify the advanced account rather than a sub-account of the advanced account. Preferences which are not explicitly selected in the update mask will not be updated. It is invalid for updates to specify an UNCONFIRMED opt-in status value. Use the name=accounts/*/users/me/emailPreferences alias to update preferences for the authenticated user.",
+"flatPath": "accounts/v1/accounts/{accountsId}/users/{usersId}/emailPreferences",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.emailPreferences.updateEmailPreferences",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The name of the EmailPreferences. The endpoint is only supported for the authenticated user.",
+"location": "path",
+"pattern": "^accounts/[^/]+/users/[^/]+/emailPreferences$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Required. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `news_and_tips`",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "EmailPreferences"
+},
+"response": {
+"$ref": "EmailPreferences"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"gbpAccounts": {
+"methods": {
+"linkGbpAccount": {
+"description": "Link the specified merchant to a GBP account for all countries. To run this method, you must have admin access to the Merchant Center account. If you don't have admin access, the request fails with the error message `User is not an administrator of account {ACCOUNT_ID}`.",
+"flatPath": "accounts/v1/accounts/{accountsId}/gbpAccounts:linkGbpAccount",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.gbpAccounts.linkGbpAccount",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The name of the parent resource to which the GBP account is linked. Format: `accounts/{account}`.",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/gbpAccounts:linkGbpAccount",
+"request": {
+"$ref": "LinkGbpAccountRequest"
+},
+"response": {
+"$ref": "LinkGbpAccountResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "List the GBP accounts for a given merchant.",
+"flatPath": "accounts/v1/accounts/{accountsId}/gbpAccounts",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.gbpAccounts.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of `GbpAccount` resources to return. The service returns fewer than this value if the number of gbp accounts is less that than the `pageSize`. The default value is 50. The maximum value is 1000; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListGbpAccounts` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `ListGbpAccounts` must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The name of the parent resource under which the GBP accounts are listed. Format: `accounts/{account}`.",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/gbpAccounts",
+"response": {
+"$ref": "ListGbpAccountsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"homepage": {
+"methods": {
+"claim": {
+"description": "Claims a store's homepage. Executing this method requires admin access. If the homepage is already claimed, this will recheck the verification (unless the business is exempted from claiming, which also exempts from verification) and return a successful response. If ownership can no longer be verified, it will return an error, but it won't clear the claim. In case of failure, a canonical error message is returned: * PERMISSION_DENIED: User doesn't have the necessary permissions on this Merchant Center account. * FAILED_PRECONDITION: - The account is not a Merchant Center account. - Merchant Center account doesn't have a homepage. - Claiming failed (in this case the error message contains more details).",
+"flatPath": "accounts/v1/accounts/{accountsId}/homepage:claim",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.homepage.claim",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the homepage to claim. Format: `accounts/{account}/homepage`",
+"location": "path",
+"pattern": "^accounts/[^/]+/homepage$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}:claim",
+"request": {
+"$ref": "ClaimHomepageRequest"
+},
+"response": {
+"$ref": "Homepage"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"getHomepage": {
+"description": "Retrieves a store's homepage.",
+"flatPath": "accounts/v1/accounts/{accountsId}/homepage",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.homepage.getHomepage",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the homepage to retrieve. Format: `accounts/{account}/homepage`",
+"location": "path",
+"pattern": "^accounts/[^/]+/homepage$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "Homepage"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"unclaim": {
+"description": "Unclaims a store's homepage. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}/homepage:unclaim",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.homepage.unclaim",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the homepage to unclaim. Format: `accounts/{account}/homepage`",
+"location": "path",
+"pattern": "^accounts/[^/]+/homepage$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}:unclaim",
+"request": {
+"$ref": "UnclaimHomepageRequest"
+},
+"response": {
+"$ref": "Homepage"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"updateHomepage": {
+"description": "Updates a store's homepage. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}/homepage",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.homepage.updateHomepage",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`",
+"location": "path",
+"pattern": "^accounts/[^/]+/homepage$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `uri`",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "Homepage"
+},
+"response": {
+"$ref": "Homepage"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"issues": {
+"methods": {
+"list": {
+"description": "Lists all account issues of a Merchant Center account. When called on a multi-client account, this method only returns issues belonging to that account, not its sub-accounts. To retrieve issues for sub-accounts, you must first call the accounts.listSubaccounts method to obtain a list of sub-accounts, and then call `accounts.issues.list` for each sub-account individually.",
+"flatPath": "accounts/v1/accounts/{accountsId}/issues",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.issues.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"languageCode": {
+"description": "Optional. The issues in the response will have human-readable fields in the given language. The format is [BCP-47](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. If not value is provided, `en-US` will be used.",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Optional. The maximum number of issues to return. The service may return fewer than this value. If unspecified, at most 50 issues will be returned. The maximum value is 100; values above 100 will be coerced to 100",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListAccountIssues` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAccountIssues` must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent, which owns this collection of issues. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+},
+"timeZone": {
+"description": "Optional. The [IANA](https://www.iana.org/time-zones) timezone used to localize times in human-readable fields. For example 'America/Los_Angeles'. If not set, 'America/Los_Angeles' will be used.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/issues",
+"response": {
+"$ref": "ListAccountIssuesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"omnichannelSettings": {
+"methods": {
+"create": {
+"description": "Create the omnichannel settings for a given merchant.",
+"flatPath": "accounts/v1/accounts/{accountsId}/omnichannelSettings",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.omnichannelSettings.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The parent resource where this omnichannel setting will be created. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/omnichannelSettings",
+"request": {
+"$ref": "OmnichannelSetting"
+},
+"response": {
+"$ref": "OmnichannelSetting"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Get the omnichannel settings for a given merchant.",
+"flatPath": "accounts/v1/accounts/{accountsId}/omnichannelSettings/{omnichannelSettingsId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.omnichannelSettings.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the omnichannel setting to retrieve. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/omnichannelSettings/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "OmnichannelSetting"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "List all the omnichannel settings for a given merchant.",
+"flatPath": "accounts/v1/accounts/{accountsId}/omnichannelSettings",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.omnichannelSettings.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of omnichannel settings to return. The service may return fewer than this value. If unspecified, at most 50 omnichannel settings 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 `ListOmnichannelSettings` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListOmnichannelSettings` must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent, which owns this collection of omnichannel settings. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/omnichannelSettings",
+"response": {
+"$ref": "ListOmnichannelSettingsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"patch": {
+"description": "Update the omnichannel setting for a given merchant in a given country.",
+"flatPath": "accounts/v1/accounts/{accountsId}/omnichannelSettings/{omnichannelSettingsId}",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.omnichannelSettings.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/omnichannelSettings/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Required. The list of fields to be updated. The following fields are supported in snake_case only: - `lsf_type` - `in_stock` - `pickup` - `odo` - `about` - `inventory_verification` Full replacement with wildcard `*`is supported, while empty/implied update mask is not.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "OmnichannelSetting"
+},
+"response": {
+"$ref": "OmnichannelSetting"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"requestInventoryVerification": {
+"description": "Requests inventory verification for a given merchant in a given country.",
+"flatPath": "accounts/v1/accounts/{accountsId}/omnichannelSettings/{omnichannelSettingsId}:requestInventoryVerification",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.omnichannelSettings.requestInventoryVerification",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the omnichannel setting to request inventory verification. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/omnichannelSettings/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}:requestInventoryVerification",
+"request": {
+"$ref": "RequestInventoryVerificationRequest"
+},
+"response": {
+"$ref": "RequestInventoryVerificationResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+},
+"resources": {
+"lfpProviders": {
+"methods": {
+"find": {
+"description": "Find the LFP provider candidates in a given country.",
+"flatPath": "accounts/v1/accounts/{accountsId}/omnichannelSettings/{omnichannelSettingsId}/lfpProviders:find",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.omnichannelSettings.lfpProviders.find",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of `LfpProvider` resources to return. The service returns fewer than this value if the number of lfp providers is less that than the `pageSize`. The default value is 50. The maximum value is 1000; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `FindLfpProviders` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `FindLfpProviders` must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The name of the parent resource under which the LFP providers are found. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/omnichannelSettings/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/lfpProviders:find",
+"response": {
+"$ref": "FindLfpProvidersResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"linkLfpProvider": {
+"description": "Link the specified merchant to a LFP provider for the specified country.",
+"flatPath": "accounts/v1/accounts/{accountsId}/omnichannelSettings/{omnichannelSettingsId}/lfpProviders/{lfpProvidersId}:linkLfpProvider",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.omnichannelSettings.lfpProviders.linkLfpProvider",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the LFP provider resource to link. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}`. The `lfp_provider` is the LFP provider ID.",
+"location": "path",
+"pattern": "^accounts/[^/]+/omnichannelSettings/[^/]+/lfpProviders/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}:linkLfpProvider",
+"request": {
+"$ref": "LinkLfpProviderRequest"
+},
+"response": {
+"$ref": "LinkLfpProviderResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+},
+"onlineReturnPolicies": {
+"methods": {
+"create": {
+"description": "Creates a new return policy for a given business.",
+"flatPath": "accounts/v1/accounts/{accountsId}/onlineReturnPolicies",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.onlineReturnPolicies.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The Merchant Center account for which the return policy will be created. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/onlineReturnPolicies",
+"request": {
+"$ref": "OnlineReturnPolicy"
+},
+"response": {
+"$ref": "OnlineReturnPolicy"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"delete": {
+"description": "Deletes an existing return policy.",
+"flatPath": "accounts/v1/accounts/{accountsId}/onlineReturnPolicies/{onlineReturnPoliciesId}",
+"httpMethod": "DELETE",
+"id": "merchantapi.accounts.onlineReturnPolicies.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the return policy to delete. Format: `accounts/{account}/onlineReturnPolicies/{return_policy}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/onlineReturnPolicies/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Gets an existing return policy for a given business.",
+"flatPath": "accounts/v1/accounts/{accountsId}/onlineReturnPolicies/{onlineReturnPoliciesId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.onlineReturnPolicies.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the return policy to retrieve. Format: `accounts/{account}/onlineReturnPolicies/{return_policy}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/onlineReturnPolicies/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "OnlineReturnPolicy"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "Lists all existing return policies for a given business.",
+"flatPath": "accounts/v1/accounts/{accountsId}/onlineReturnPolicies",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.onlineReturnPolicies.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of `OnlineReturnPolicy` resources to return. The service returns fewer than this value if the number of return policies for the given business is less that than the `pageSize`. The default value is 10. The maximum value is 100; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListOnlineReturnPolicies` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `ListOnlineReturnPolicies` must match the call that provided the page token. The token returned as nextPageToken in the response to the previous request.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The Merchant Center account for which to list return policies. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/onlineReturnPolicies",
+"response": {
+"$ref": "ListOnlineReturnPoliciesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"programs": {
+"methods": {
+"disable": {
+"description": "Disable participation in the specified program for the account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/programs/{programsId}:disable",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.programs.disable",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the program for which to disable participation for the given account. Format: `accounts/{account}/programs/{program}`. For example, `accounts/123456/programs/free-listings`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/programs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}:disable",
+"request": {
+"$ref": "DisableProgramRequest"
+},
+"response": {
+"$ref": "Program"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"enable": {
+"description": "Enable participation in the specified program for the account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/programs/{programsId}:enable",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.programs.enable",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the program for which to enable participation for the given account. Format: `accounts/{account}/programs/{program}`. For example, `accounts/123456/programs/free-listings`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/programs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}:enable",
+"request": {
+"$ref": "EnableProgramRequest"
+},
+"response": {
+"$ref": "Program"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Retrieves the specified program for the account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/programs/{programsId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.programs.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the program to retrieve. Format: `accounts/{account}/programs/{program}`. For example, `accounts/123456/programs/free-listings`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/programs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "Program"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "Retrieves all programs for the account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/programs",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.programs.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of programs to return in a single response. If unspecified (or 0), a default size of 1000 is used. The maximum value is 1000; values above 1000 will be coerced to 1000.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A continuation token, received from a previous `ListPrograms` call. Provide this to retrieve the next page.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The name of the account for which to retrieve all programs. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/programs",
+"response": {
+"$ref": "ListProgramsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+},
+"resources": {
+"checkoutSettings": {
+"methods": {
+"create": {
+"description": "Creates `CheckoutSettings` for the given merchant.",
+"flatPath": "accounts/v1/accounts/{accountsId}/programs/{programsId}/checkoutSettings",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.programs.checkoutSettings.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The merchant account for which the `CheckoutSettings` will be created.",
+"location": "path",
+"pattern": "^accounts/[^/]+/programs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/checkoutSettings",
+"request": {
+"$ref": "CheckoutSettings"
+},
+"response": {
+"$ref": "CheckoutSettings"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"deleteCheckoutSettings": {
+"description": "Deletes `CheckoutSettings` and unenrolls merchant from `Checkout` program.",
+"flatPath": "accounts/v1/accounts/{accountsId}/programs/{programsId}/checkoutSettings",
+"httpMethod": "DELETE",
+"id": "merchantapi.accounts.programs.checkoutSettings.deleteCheckoutSettings",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name/identifier of the merchant account. Format: `accounts/{account}/programs/{program}/checkoutSettings`",
+"location": "path",
+"pattern": "^accounts/[^/]+/programs/[^/]+/checkoutSettings$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"getCheckoutSettings": {
+"description": "Gets `CheckoutSettings` for the given merchant. This includes information about review state, enrollment state and URL settings.",
+"flatPath": "accounts/v1/accounts/{accountsId}/programs/{programsId}/checkoutSettings",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.programs.checkoutSettings.getCheckoutSettings",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name/identifier of the merchant account. Format: `accounts/{account}/programs/{program}/checkoutSettings`",
+"location": "path",
+"pattern": "^accounts/[^/]+/programs/[^/]+/checkoutSettings$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "CheckoutSettings"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"updateCheckoutSettings": {
+"description": "Updates `CheckoutSettings` for the given merchant.",
+"flatPath": "accounts/v1/accounts/{accountsId}/programs/{programsId}/checkoutSettings",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.programs.checkoutSettings.updateCheckoutSettings",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the program configuration settings. Format: `accounts/{account}/programs/{program}/checkoutSettings`",
+"location": "path",
+"pattern": "^accounts/[^/]+/programs/[^/]+/checkoutSettings$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Required. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `eligible_destinations` - `uri_settings`",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "CheckoutSettings"
+},
+"response": {
+"$ref": "CheckoutSettings"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+},
+"regions": {
+"methods": {
+"create": {
+"description": "Creates a region definition in your Merchant Center account. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}/regions",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.regions.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The account to create a region for. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+},
+"regionId": {
+"description": "Required. The identifier for the region, unique over all regions of the same account.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/regions",
+"request": {
+"$ref": "Region"
+},
+"response": {
+"$ref": "Region"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"delete": {
+"description": "Deletes a region definition from your Merchant Center account. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}/regions/{regionsId}",
+"httpMethod": "DELETE",
+"id": "merchantapi.accounts.regions.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the region to delete. Format: `accounts/{account}/regions/{region}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/regions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Retrieves a region defined in your Merchant Center account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/regions/{regionsId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.regions.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the region to retrieve. Format: `accounts/{account}/regions/{region}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/regions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "Region"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "Lists the regions in your Merchant Center account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/regions",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.regions.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of regions to return. The service may return fewer than this value. If unspecified, at most 50 regions 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 `ListRegions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListRegions` must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The account to list regions for. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/regions",
+"response": {
+"$ref": "ListRegionsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"patch": {
+"description": "Updates a region definition in your Merchant Center account. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}/regions/{regionsId}",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.regions.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the region. Format: `accounts/{account}/regions/{region}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/regions/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. The comma-separated field mask indicating the fields to update. Example: `\"displayName,postalCodeArea.regionCode\"`.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "Region"
+},
+"response": {
+"$ref": "Region"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"relationships": {
+"methods": {
+"get": {
+"description": "Retrieve an account relationship.",
+"flatPath": "accounts/v1/accounts/{accountsId}/relationships/{relationshipsId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.relationships.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the account relationship to get. Format: `accounts/{account}/relationships/{relationship}`. For example, `accounts/123456/relationships/567890`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/relationships/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "AccountRelationship"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "List account relationships for the specified account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/relationships",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.relationships.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of elements to return in the response. Use for paging. If no `page_size` is specified, `100` is used as the default value. The maximum allowed value is `1000`.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. The token returned by the previous `list` request.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent account of the account relationship to filter by. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/relationships",
+"response": {
+"$ref": "ListAccountRelationshipsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"patch": {
+"description": "Updates the account relationship. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}/relationships/{relationshipsId}",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.relationships.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the account relationship. Format: `accounts/{account}/relationships/{relationship}`. For example, `accounts/123456/relationships/567890`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/relationships/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `account_id_alias`",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "AccountRelationship"
+},
+"response": {
+"$ref": "AccountRelationship"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"services": {
+"methods": {
+"approve": {
+"description": "Approve an account service proposal.",
+"flatPath": "accounts/v1/accounts/{accountsId}/services/{servicesId}:approve",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.services.approve",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the account service to approve. Format: `accounts/{account}/services/{service}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/services/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}:approve",
+"request": {
+"$ref": "ApproveAccountServiceRequest"
+},
+"response": {
+"$ref": "AccountService"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Retrieve an account service.",
+"flatPath": "accounts/v1/accounts/{accountsId}/services/{servicesId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.services.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the account service to get. Format: `accounts/{account}/services/{service}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/services/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "AccountService"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "List account services for the specified accounts. Supports filtering.",
+"flatPath": "accounts/v1/accounts/{accountsId}/services",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.services.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of elements to return in the response. Use for paging. If no `page_size` is specified, `100` is used as the default value. The maximum allowed value is `1000`.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. The token returned by the previous `list` request.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent account of the account service to filter by. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/services",
+"response": {
+"$ref": "ListAccountServicesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"propose": {
+"description": "Propose an account service.",
+"flatPath": "accounts/v1/accounts/{accountsId}/services:propose",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.services.propose",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The resource name of the parent account for the service. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/services:propose",
+"request": {
+"$ref": "ProposeAccountServiceRequest"
+},
+"response": {
+"$ref": "AccountService"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"reject": {
+"description": "Reject an account service (both proposed and approve services can be rejected).",
+"flatPath": "accounts/v1/accounts/{accountsId}/services/{servicesId}:reject",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.services.reject",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the account service to reject. Format: `accounts/{account}/services/{service}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/services/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}:reject",
+"request": {
+"$ref": "RejectAccountServiceRequest"
+},
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"shippingSettings": {
+"methods": {
+"getShippingSettings": {
+"description": "Retrieve shipping setting information.",
+"flatPath": "accounts/v1/accounts/{accountsId}/shippingSettings",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.shippingSettings.getShippingSettings",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the shipping setting to retrieve. Format: `accounts/{account}/shippingsettings`",
+"location": "path",
+"pattern": "^accounts/[^/]+/shippingSettings$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "ShippingSettings"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"insert": {
+"description": "Replace the shipping setting of a business with the request shipping setting. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}/shippingSettings:insert",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.shippingSettings.insert",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The account for which this shipping setting will be inserted. If you are using an advanced account, you must specify the unique identifier of the sub-account for which you want to insert the shipping setting. Format: `accounts/{ACCOUNT_ID}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/shippingSettings:insert",
+"request": {
+"$ref": "ShippingSettings"
+},
+"response": {
+"$ref": "ShippingSettings"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"termsOfServiceAgreementStates": {
+"methods": {
+"get": {
+"description": "Returns the state of a terms of service agreement.",
+"flatPath": "accounts/v1/accounts/{accountsId}/termsOfServiceAgreementStates/{termsOfServiceAgreementStatesId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.termsOfServiceAgreementStates.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the terms of service version. Format: `accounts/{account}/termsOfServiceAgreementStates/{identifier}` The identifier format is: `{TermsOfServiceKind}-{country}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/termsOfServiceAgreementStates/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "TermsOfServiceAgreementState"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"retrieveForApplication": {
+"description": "Retrieves the state of the agreement for the application terms of service. Application terms of service covers permissions related to the usage of data provided through Merchant Center, CSS Center, Manufacturer Center, and more.",
+"flatPath": "accounts/v1/accounts/{accountsId}/termsOfServiceAgreementStates:retrieveForApplication",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.termsOfServiceAgreementStates.retrieveForApplication",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The account for which to get a TermsOfServiceAgreementState Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/termsOfServiceAgreementStates:retrieveForApplication",
+"response": {
+"$ref": "TermsOfServiceAgreementState"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"users": {
+"methods": {
+"create": {
+"description": "Creates a Merchant Center account user. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}/users",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.users.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The resource name of the account for which a user will be created. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+},
+"userId": {
+"description": "Required. The email address of the user (for example, `john.doe@gmail.com`).",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/users",
+"request": {
+"$ref": "User"
+},
+"response": {
+"$ref": "User"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"delete": {
+"description": "Deletes a Merchant Center account user. Executing this method requires admin access. The user to be deleted can't be the last admin user of that account. Also a user is protected from deletion if it is managed by Business Manager\"",
+"flatPath": "accounts/v1/accounts/{accountsId}/users/{usersId}",
+"httpMethod": "DELETE",
+"id": "merchantapi.accounts.users.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the user to delete. Format: `accounts/{account}/users/{email}` It is also possible to delete the user corresponding to the caller by using `me` rather than an email address as in `accounts/{account}/users/me`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/users/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Retrieves a Merchant Center account user.",
+"flatPath": "accounts/v1/accounts/{accountsId}/users/{usersId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.users.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the user to retrieve. Format: `accounts/{account}/users/{email}` It is also possible to retrieve the user corresponding to the caller by using `me` rather than an email address as in `accounts/{account}/users/me`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/users/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "User"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "Lists all users of a Merchant Center account.",
+"flatPath": "accounts/v1/accounts/{accountsId}/users",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.users.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of users to return. The service may return fewer than this value. If unspecified, at most 50 users will be returned. The maximum value is 100; values above 100 will be coerced to 100",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListUsers` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUsers` must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent, which owns this collection of users. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+parent}/users",
+"response": {
+"$ref": "ListUsersResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"patch": {
+"description": "Updates a Merchant Center account user. Executing this method requires admin access.",
+"flatPath": "accounts/v1/accounts/{accountsId}/users/{usersId}",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.users.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the user. Format: `accounts/{account}/user/{email}` Use `me` to refer to your own email address, for example `accounts/{account}/users/me`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/users/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `access_rights`",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"request": {
+"$ref": "User"
+},
+"response": {
+"$ref": "User"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+},
+"termsOfService": {
+"methods": {
+"accept": {
+"description": "Accepts a `TermsOfService`. Executing this method requires admin access.",
+"flatPath": "accounts/v1/termsOfService/{termsOfServiceId}:accept",
+"httpMethod": "POST",
+"id": "merchantapi.termsOfService.accept",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"account": {
+"description": "Required. The account for which to accept the ToS. Format: `accounts/{account}`",
+"location": "query",
+"type": "string"
+},
+"name": {
+"description": "Required. The resource name of the terms of service version. Format: `termsOfService/{version}`",
+"location": "path",
+"pattern": "^termsOfService/[^/]+$",
+"required": true,
+"type": "string"
+},
+"regionCode": {
+"description": "Required. Region code as defined by [CLDR](https://cldr.unicode.org/). This is either a country when the ToS applies specifically to that country or 001 when it applies globally.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}:accept",
+"response": {
+"$ref": "AcceptTermsOfServiceResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Retrieves the `TermsOfService` associated with the provided version.",
+"flatPath": "accounts/v1/termsOfService/{termsOfServiceId}",
+"httpMethod": "GET",
+"id": "merchantapi.termsOfService.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the terms of service version. Format: `termsOfService/{version}`",
+"location": "path",
+"pattern": "^termsOfService/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1/{+name}",
+"response": {
+"$ref": "TermsOfService"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"retrieveLatest": {
+"description": "Retrieves the latest version of the `TermsOfService` for a given `kind` and `region_code`.",
+"flatPath": "accounts/v1/termsOfService:retrieveLatest",
+"httpMethod": "GET",
+"id": "merchantapi.termsOfService.retrieveLatest",
+"parameterOrder": [],
+"parameters": {
+"kind": {
+"description": "Required. The Kind this terms of service version applies to.",
+"enum": [
+"TERMS_OF_SERVICE_KIND_UNSPECIFIED",
+"MERCHANT_CENTER"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Merchant Center application."
+],
+"location": "query",
+"type": "string"
+},
+"regionCode": {
+"description": "Required. Region code as defined by [CLDR](https://cldr.unicode.org/). This is either a country when the ToS applies specifically to that country or 001 when it applies globally.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "accounts/v1/termsOfService:retrieveLatest",
+"response": {
+"$ref": "TermsOfService"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+},
+"revision": "20250804",
+"rootUrl": "https://merchantapi.googleapis.com/",
+"schemas": {
+"About": {
+"description": "Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)).",
+"id": "About",
+"properties": {
+"state": {
+"description": "Output only. The state of the URI.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ACTIVE",
+"FAILED",
+"RUNNING",
+"ACTION_REQUIRED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The review process has concluded successfully. The reviewed item is active.",
+"The review process failed.",
+"The review process is running.",
+"The review process is waiting for the merchant to take action."
+],
+"readOnly": true,
+"type": "string"
+},
+"uri": {
+"description": "Required. The about page URI.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"AcceptTermsOfServiceResponse": {
+"description": "Response message for the `AcceptTermsOfService` method.",
+"id": "AcceptTermsOfServiceResponse",
+"properties": {
+"termsOfServiceAgreementState": {
+"$ref": "TermsOfServiceAgreementState",
+"description": "The agreement state after accepting the ToS."
+}
+},
+"type": "object"
+},
+"Accepted": {
+"description": "Describes the [accepted terms of service](https://developers.google.com/merchant/api/guides/accounts/create-and-configure#accept_the_merchant_center_terms_of_service).",
+"id": "Accepted",
+"properties": {
+"acceptedBy": {
+"description": "Required. The account where the acceptance was recorded. This can be the account itself or, in the case of subaccounts, the advanced account.",
+"type": "string"
+},
+"termsOfService": {
+"description": "Required. The accepted termsOfService.",
+"type": "string"
+},
+"validUntil": {
+"$ref": "Date",
+"description": "Optional. When set, it states that the accepted `TermsOfService` is only valid until the end of this date (in UTC). A new one must be accepted before then. The information of the required `TermsOfService` is found in the `Required` message."
+}
+},
+"type": "object"
+},
+"Account": {
+"description": "The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on.",
+"id": "Account",
+"properties": {
+"accountId": {
+"description": "Output only. The ID of the account.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"accountName": {
+"description": "Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.",
+"type": "string"
+},
+"adultContent": {
+"description": "Optional. Whether this account contains adult content.",
+"type": "boolean"
+},
+"languageCode": {
+"description": "Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`.",
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the account. Format: `accounts/{account}`",
+"type": "string"
+},
+"testAccount": {
+"description": "Output only. Whether this is a test account.",
+"readOnly": true,
+"type": "boolean"
+},
+"timeZone": {
+"$ref": "TimeZone",
+"description": "Required. The time zone of the account. On writes, `time_zone` sets both the `reporting_time_zone` and the `display_time_zone`. For reads, `time_zone` always returns the `display_time_zone`. If `display_time_zone` doesn't exist for your account, `time_zone` is empty. The `version` field is not supported, won't be set in responses and will be silently ignored if specified in requests."
+}
+},
+"type": "object"
+},
+"AccountAggregation": {
+"description": "`AccountAggregation` payload.",
+"id": "AccountAggregation",
+"properties": {},
+"type": "object"
+},
+"AccountIssue": {
+"description": "Issues with your Merchant Center account that can impact all your products. For more information, see [Account-level issues in Merchant Center](https://support.google.com/merchants/answer/12153802?sjid=17798438912526418908-EU#account).",
+"id": "AccountIssue",
+"properties": {
+"detail": {
+"description": "Further localized details about the issue.",
+"type": "string"
+},
+"documentationUri": {
+"description": "Link to Merchant Center Help Center providing further information about the issue and how to fix it.",
+"type": "string"
+},
+"impactedDestinations": {
+"description": "The impact this issue has on various destinations.",
+"items": {
+"$ref": "ImpactedDestination"
+},
+"type": "array"
+},
+"name": {
+"description": "Identifier. The resource name of the account issue. Format: `accounts/{account}/issues/{id}`. For example, `accounts/123456/issues/misrepresentation-of-self-or-products-unacceptable-business-practice-policy`.",
+"type": "string"
+},
+"severity": {
+"description": "The overall severity of the issue.",
+"enum": [
+"SEVERITY_UNSPECIFIED",
+"CRITICAL",
+"ERROR",
+"SUGGESTION"
+],
+"enumDescriptions": [
+"The severity is unknown.",
+"The issue causes offers to not serve.",
+"The issue might affect offers (in the future) or might be an indicator of issues with offers.",
+"The issue is a suggestion for improvement."
+],
+"type": "string"
+},
+"title": {
+"description": "The localized title of the issue.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"AccountManagement": {
+"description": "`AccountManagement` payload.",
+"id": "AccountManagement",
+"properties": {},
+"type": "object"
+},
+"AccountRelationship": {
+"description": "The `AccountRelationship` message defines a formal connection between a merchant's account and a service provider's account. This relationship enables the provider to offer specific services to the business, such as product management or campaign management. It specifies the access rights and permissions to the business's data relevant to those services. Establishing an account relationship involves linking the merchant's account with a provider's account. The provider could be another Google account (like Google Ads or Google My Business) or a third-party platform (such as Shopify or WooCommerce).",
+"id": "AccountRelationship",
+"properties": {
+"accountIdAlias": {
+"description": "Optional. An optional alias you can assign to this account relationship. This alias acts as a convenient identifier for your own reference and management. It must be unique among all your account relationships with the same provider. For example, you might use `account_id_alias` to assign a friendly name to this relationship for easier identification in your systems.",
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the account relationship. Format: `accounts/{account}/relationships/{relationship}`. For example, `accounts/123456/relationships/567890`.",
+"type": "string"
+},
+"provider": {
+"description": "Immutable. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).",
+"type": "string"
+},
+"providerDisplayName": {
+"description": "Output only. The human-readable display name of the provider account.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"AccountService": {
+"description": "The `AccountService` message represents a specific service that a provider account offers to a Merchant Center account. `AccountService` defines the permissions and capabilities granted to the provider, allowing for operations such as product management or campaign management. The lifecycle of an `AccountService` involves a proposal phase, where one party suggests the service, and an approval phase, where the other party accepts or rejects it. This handshake mechanism ensures mutual consent before any access is granted. This mechanism safeguards both parties by ensuring that access rights are granted appropriately and that both the business and provider are aware of the services enabled. In scenarios where a user is an admin of both accounts, the approval can happen automatically. The mutability of a service is also managed through `AccountService`. Some services might be immutable, for example, if they were established through other systems or APIs, and you cannot alter them through this API.",
+"id": "AccountService",
+"properties": {
+"accountAggregation": {
+"$ref": "AccountAggregation",
+"description": "Service type for account aggregation. This enables the provider, which is an advanced account, to manage multiple sub-accounts (client accounts). Through this service, the advanced account provider can perform administrative and operational tasks across all linked sub-accounts. This is useful for agencies, aggregators, or large retailers that need centralized control over many Merchant Center accounts."
+},
+"accountManagement": {
+"$ref": "AccountManagement",
+"description": "Service type for account management. Enables the provider to perform administrative actions on the business's account, such as configuring account settings, managing users, or updating business information."
+},
+"campaignsManagement": {
+"$ref": "CampaignsManagement",
+"description": "Service type for managing advertising campaigns. Grants the provider access to create and manage the business's ad campaigns, including setting up campaigns, adjusting bids, and optimizing performance."
+},
+"externalAccountId": {
+"description": "Immutable. An optional, immutable identifier that Google uses to refer to this account when communicating with the provider. This should be the unique account ID within the provider's system (for example, your shop ID in Shopify). If you have multiple accounts with the same provider - for instance, different accounts for various regions \u2014 the `external_account_id` differentiates between them, ensuring accurate linking and integration between Google and the provider.",
+"type": "string"
+},
+"handshake": {
+"$ref": "Handshake",
+"description": "Output only. Information about the state of the service in terms of establishing it (e.g. is it pending approval or approved).",
+"readOnly": true
+},
+"localListingManagement": {
+"$ref": "LocalListingManagement",
+"description": "Service type for local listings management. The business group associated with the external account id will be used to provide local inventory to this Merchant Center account."
+},
+"mutability": {
+"description": "Output only. Whether the service is mutable (e.g. through Approve / Reject RPCs). A service that was created through another system or API might be immutable.",
+"enum": [
+"MUTABILITY_UNSPECIFIED",
+"MUTABLE",
+"IMMUTABLE"
+],
+"enumDescriptions": [
+"Unused default value",
+"The service can be mutated without restrictions.",
+"The service is read-only and must not be mutated."
+],
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the account service. Format: `accounts/{account}/services/{service}`",
+"type": "string"
+},
+"productsManagement": {
+"$ref": "ProductsManagement",
+"description": "Service type for managing products. This allows the provider to handle product data on behalf of the business, including reading and writing product listings. It's commonly used when the provider offers inventory management or catalog synchronization services to keep the business's product information up-to-date across platforms."
+},
+"provider": {
+"description": "Output only. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).",
+"readOnly": true,
+"type": "string"
+},
+"providerDisplayName": {
+"description": "Output only. The human-readable display name of the provider account.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"AddAccountService": {
+"description": "Additional instructions to add account services during creation of the account.",
+"id": "AddAccountService",
+"properties": {
+"accountAggregation": {
+"$ref": "AccountAggregation",
+"description": "The provider is an [aggregator](https://support.google.com/merchants/answer/188487) for the account. Payload for service type Account Aggregation."
+},
+"provider": {
+"description": "Required. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"AddUser": {
+"description": "Instruction for adding a user to the account during creation.",
+"id": "AddUser",
+"properties": {
+"user": {
+"$ref": "User",
+"description": "Optional. Details about the user to be added. At the moment, only access rights may be specified."
+},
+"userId": {
+"description": "Required. The email address of the user (for example, `john.doe@gmail.com`).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"Address": {
+"description": "Shipping address of the warehouse.",
+"id": "Address",
+"properties": {
+"administrativeArea": {
+"description": "Required. Top-level administrative subdivision of the country. For example, a state like California (\"CA\") or a province like Quebec (\"QC\").",
+"type": "string"
+},
+"city": {
+"description": "Required. City, town or commune. May also include dependent localities or sublocalities (For example neighborhoods or suburbs).",
+"type": "string"
+},
+"postalCode": {
+"description": "Required. Postal code or ZIP (For example \"94043\").",
+"type": "string"
+},
+"regionCode": {
+"description": "Required. [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (For example \"US\").",
+"type": "string"
+},
+"streetAddress": {
+"description": "Street-level part of the address. For example: `111w 31st Street`.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ApproveAccountServiceRequest": {
+"description": "Request to approve an account service.",
+"id": "ApproveAccountServiceRequest",
+"properties": {},
+"type": "object"
+},
+"AutofeedSettings": {
+"description": "Collection of information related to the [autofeed](https://support.google.com/merchants/answer/7538732) settings.",
+"id": "AutofeedSettings",
+"properties": {
+"eligible": {
+"description": "Output only. Determines whether the business is eligible for being enrolled into an autofeed.",
+"readOnly": true,
+"type": "boolean"
+},
+"enableProducts": {
+"description": "Required. Enables or disables product crawling through the autofeed for the given account. Autofeed accounts must meet [certain conditions](https://support.google.com/merchants/answer/7538732#Configure_automated_feeds_Standard_Experience), which can be checked through the `eligible` field. The account must **not** be a marketplace. When the autofeed is enabled for the first time, the products usually appear instantly. When re-enabling, it might take up to 24 hours for products to appear.",
+"type": "boolean"
+},
+"name": {
+"description": "Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"AutomaticImageImprovements": {
+"description": "This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973)",
+"id": "AutomaticImageImprovements",
+"properties": {
+"accountImageImprovementsSettings": {
+"$ref": "ImageImprovementsAccountLevelSettings",
+"description": "Optional. Determines how the images should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator."
+},
+"effectiveAllowAutomaticImageImprovements": {
+"description": "Output only. The effective value of allow_automatic_image_improvements. If account_image_improvements_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.",
+"readOnly": true,
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"AutomaticImprovements": {
+"description": "Collection of information related to the [automatic improvements](https://developers.google.com/shopping-content/guides/automatic-improvements) of an account.",
+"id": "AutomaticImprovements",
+"properties": {
+"imageImprovements": {
+"$ref": "AutomaticImageImprovements",
+"description": "This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) This field is only updated (cleared) if provided in the update mask."
+},
+"itemUpdates": {
+"$ref": "AutomaticItemUpdates",
+"description": "Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. This field is only updated (cleared) if provided in the update mask."
+},
+"name": {
+"description": "Identifier. The resource name of the automatic improvements. Format: `accounts/{account}/automaticImprovements`.",
+"type": "string"
+},
+"shippingImprovements": {
+"$ref": "AutomaticShippingImprovements",
+"description": "Not available for [advanced accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data This field is only updated (cleared) if provided in the update mask."
+}
+},
+"type": "object"
+},
+"AutomaticItemUpdates": {
+"description": "Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown.",
+"id": "AutomaticItemUpdates",
+"properties": {
+"accountItemUpdatesSettings": {
+"$ref": "ItemUpdatesAccountLevelSettings",
+"description": "Optional. Determines which attributes of the items should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator."
+},
+"effectiveAllowAvailabilityUpdates": {
+"description": "Output only. The effective value of allow_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.",
+"readOnly": true,
+"type": "boolean"
+},
+"effectiveAllowConditionUpdates": {
+"description": "Output only. The effective value of allow_condition_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.",
+"readOnly": true,
+"type": "boolean"
+},
+"effectiveAllowPriceUpdates": {
+"description": "Output only. The effective value of allow_price_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.",
+"readOnly": true,
+"type": "boolean"
+},
+"effectiveAllowStrictAvailabilityUpdates": {
+"description": "Output only. The effective value of allow_strict_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.",
+"readOnly": true,
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"AutomaticShippingImprovements": {
+"description": "Not available for [advanced accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data",
+"id": "AutomaticShippingImprovements",
+"properties": {
+"allowShippingImprovements": {
+"description": "Enables automatic shipping improvements.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"BusinessDayConfig": {
+"description": "Business days of the warehouse.",
+"id": "BusinessDayConfig",
+"properties": {
+"businessDays": {
+"description": "Required. Regular business days. May not be empty.",
+"items": {
+"enum": [
+"WEEKDAY_UNSPECIFIED",
+"MONDAY",
+"TUESDAY",
+"WEDNESDAY",
+"THURSDAY",
+"FRIDAY",
+"SATURDAY",
+"SUNDAY"
+],
+"enumDescriptions": [
+"",
+"",
+"",
+"",
+"",
+"",
+"",
+""
+],
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"BusinessIdentity": {
+"description": "Collection of information related to the [identity of a business](https://support.google.com/merchants/answer/12564247).",
+"id": "BusinessIdentity",
+"properties": {
+"blackOwned": {
+"$ref": "IdentityAttribute",
+"description": "Optional. Specifies whether the business identifies itself as being black-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers."
+},
+"latinoOwned": {
+"$ref": "IdentityAttribute",
+"description": "Optional. Specifies whether the business identifies itself as being latino-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers."
+},
+"name": {
+"description": "Identifier. The resource name of the business identity. Format: `accounts/{account}/businessIdentity`",
+"type": "string"
+},
+"promotionsConsent": {
+"description": "Required. Whether the identity attributes may be used for promotions.",
+"enum": [
+"PROMOTIONS_CONSENT_UNSPECIFIED",
+"PROMOTIONS_CONSENT_GIVEN",
+"PROMOTIONS_CONSENT_DENIED"
+],
+"enumDescriptions": [
+"Default value indicating that no selection was made.",
+"Indicates that the account consented to having their business identity used for promotions.",
+"Indicates that the account did not consent to having their business identity used for promotions."
+],
+"type": "string"
+},
+"smallBusiness": {
+"$ref": "IdentityAttribute",
+"description": "Optional. Specifies whether the business identifies itself as a small business. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces."
+},
+"veteranOwned": {
+"$ref": "IdentityAttribute",
+"description": "Optional. Specifies whether the business identifies itself as being veteran-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers."
+},
+"womenOwned": {
+"$ref": "IdentityAttribute",
+"description": "Optional. Specifies whether the business identifies itself as being women-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers."
+}
+},
+"type": "object"
+},
+"BusinessInfo": {
+"description": "The `BusinessInfo` message contains essential information about a business. This message captures key business details such as physical address, customer service contacts, and region-specific identifiers.",
+"id": "BusinessInfo",
+"properties": {
+"address": {
+"$ref": "PostalAddress",
+"description": "Optional. The address of the business. Only `region_code`, `address_lines`, `postal_code`, `administrative_area` and `locality` fields are supported. All other fields are ignored."
+},
+"customerService": {
+"$ref": "CustomerService",
+"description": "Optional. The customer service of the business."
+},
+"koreanBusinessRegistrationNumber": {
+"description": "Optional. The 10-digit [Korean business registration number](https://support.google.com/merchants/answer/9037766) separated with dashes in the format: XXX-XX-XXXXX.",
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the business info. Format: `accounts/{account}/businessInfo`",
+"type": "string"
+},
+"phone": {
+"$ref": "PhoneNumber",
+"description": "Output only. The phone number of the business.",
+"readOnly": true
+},
+"phoneVerificationState": {
+"description": "Output only. The phone verification state of the business.",
+"enum": [
+"PHONE_VERIFICATION_STATE_UNSPECIFIED",
+"PHONE_VERIFICATION_STATE_VERIFIED",
+"PHONE_VERIFICATION_STATE_UNVERIFIED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The phone is verified.",
+"The phone is unverified."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"CampaignsManagement": {
+"description": "`CampaignManagement` payload.",
+"id": "CampaignsManagement",
+"properties": {},
+"type": "object"
+},
+"CarrierRate": {
+"description": "A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported carrier services are defined in https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.",
+"id": "CarrierRate",
+"properties": {
+"carrier": {
+"description": "Required. Carrier service, such as `\"UPS\"` or `\"Fedex\"`.",
+"type": "string"
+},
+"carrierService": {
+"description": "Required. Carrier service, such as `\"ground\"` or `\"2 days\"`.",
+"type": "string"
+},
+"flatAdjustment": {
+"$ref": "Price",
+"description": "Optional. Additive shipping rate modifier. Can be negative. For example `{ \"amount_micros\": 1, \"currency_code\" : \"USD\" }` adds $1 to the rate, `{ \"amount_micros\": -3, \"currency_code\" : \"USD\" }` removes $3 from the rate."
+},
+"name": {
+"description": "Required. Name of the carrier rate. Must be unique per rate group.",
+"type": "string"
+},
+"originPostalCode": {
+"description": "Required. Shipping origin for this carrier rate.",
+"type": "string"
+},
+"percentageAdjustment": {
+"description": "Optional. Multiplicative shipping rate modifier as a number in decimal notation. Can be negative. For example `\"5.4\"` increases the rate by 5.4%, `\"-3\"` decreases the rate by 3%.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"CheckoutSettings": {
+"description": "[CheckoutSettings](https://support.google.com/merchants/answer/13945960) for a specific merchant.",
+"id": "CheckoutSettings",
+"properties": {
+"effectiveEnrollmentState": {
+"description": "Output only. The effective value of enrollment_state for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).",
+"enum": [
+"CHECKOUT_ENROLLMENT_STATE_UNSPECIFIED",
+"INACTIVE",
+"ENROLLED",
+"OPTED_OUT"
+],
+"enumDescriptions": [
+"Default enrollment state when enrollment state is not specified.",
+"Merchant has not enrolled into the program.",
+"Merchant has enrolled into the program by providing either an account level URL or checkout URLs as part of their feed.",
+"Merchant has previously enrolled but opted out of the program."
+],
+"readOnly": true,
+"type": "string"
+},
+"effectiveReviewState": {
+"description": "Output only. The effective value of `review_state` for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).",
+"enum": [
+"CHECKOUT_REVIEW_STATE_UNSPECIFIED",
+"IN_REVIEW",
+"APPROVED",
+"DISAPPROVED"
+],
+"enumDescriptions": [
+"Default review state when review state is not specified.",
+"Merchant provided URLs are being reviewed for data quality issues.",
+"Merchant account has been approved. Indicates the data quality checks have passed.",
+"Merchant account has been disapproved due to data quality issues."
+],
+"readOnly": true,
+"type": "string"
+},
+"effectiveUriSettings": {
+"$ref": "UriSettings",
+"description": "Output only. The effective value of `uri_settings` for a given merchant. If account level settings are present then this value will be a copy of url settings. Otherwise, it will have the value of the parent account (for only marketplace sellers).",
+"readOnly": true
+},
+"eligibleDestinations": {
+"description": "Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`",
+"items": {
+"enum": [
+"DESTINATION_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"YOUTUBE_SHOPPING",
+"YOUTUBE_SHOPPING_CHECKOUT",
+"YOUTUBE_AFFILIATE",
+"FREE_VEHICLE_LISTINGS",
+"VEHICLE_ADS",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL"
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/google-ads/answer/2454022).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3057972).",
+"[Free listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/12362804).",
+"Youtube shopping checkout.",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[Free vehicle listings](https://support.google.com/merchants/answer/11189169).",
+"[Vehicle ads](https://support.google.com/merchants/answer/11189169).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail)."
+],
+"type": "string"
+},
+"type": "array"
+},
+"enrollmentState": {
+"description": "Output only. Reflects the merchant enrollment state in `Checkout` program.",
+"enum": [
+"CHECKOUT_ENROLLMENT_STATE_UNSPECIFIED",
+"INACTIVE",
+"ENROLLED",
+"OPTED_OUT"
+],
+"enumDescriptions": [
+"Default enrollment state when enrollment state is not specified.",
+"Merchant has not enrolled into the program.",
+"Merchant has enrolled into the program by providing either an account level URL or checkout URLs as part of their feed.",
+"Merchant has previously enrolled but opted out of the program."
+],
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the program configuration settings. Format: `accounts/{account}/programs/{program}/checkoutSettings`",
+"type": "string"
+},
+"reviewState": {
+"description": "Output only. Reflects the merchant review state in `Checkout` program. This is set based on the data quality reviews of the URL provided by the merchant. A merchant with enrollment state as `ENROLLED` can be in the following review states: `IN_REVIEW`, `APPROVED` or `DISAPPROVED`. A merchant must be in an `enrollment_state` of `ENROLLED` before a review can begin for the merchant.For more details, check the help center doc.",
+"enum": [
+"CHECKOUT_REVIEW_STATE_UNSPECIFIED",
+"IN_REVIEW",
+"APPROVED",
+"DISAPPROVED"
+],
+"enumDescriptions": [
+"Default review state when review state is not specified.",
+"Merchant provided URLs are being reviewed for data quality issues.",
+"Merchant account has been approved. Indicates the data quality checks have passed.",
+"Merchant account has been disapproved due to data quality issues."
+],
+"readOnly": true,
+"type": "string"
+},
+"uriSettings": {
+"$ref": "UriSettings",
+"description": "URI settings for cart or checkout URL."
+}
+},
+"type": "object"
+},
+"ClaimHomepageRequest": {
+"description": "Request message for the `ClaimHomepage` method.",
+"id": "ClaimHomepageRequest",
+"properties": {
+"overwrite": {
+"description": "Optional. When set to `true`, this option removes any existing claim on the requested website from any other account to the account making the request, effectively replacing the previous claim.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"CreateAndConfigureAccountRequest": {
+"description": "Request message for the `CreateAndConfigureAccount` method.",
+"id": "CreateAndConfigureAccountRequest",
+"properties": {
+"account": {
+"$ref": "Account",
+"description": "Required. The account to be created."
+},
+"service": {
+"description": "Required. An account service between the account to be created and the provider account is initialized as part of the creation. At least one such service needs to be provided. Currently exactly one of these needs to be `account_aggregation` and `accounts.createAndConfigure` method can be used to create a sub-account under an existing advanced account through this method. Additional `account_management` or `product_management` services may be provided.",
+"items": {
+"$ref": "AddAccountService"
+},
+"type": "array"
+},
+"user": {
+"description": "Optional. Users to be added to the account.",
+"items": {
+"$ref": "AddUser"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"CustomerService": {
+"description": "Customer service information.",
+"id": "CustomerService",
+"properties": {
+"email": {
+"description": "Optional. The email address where customer service may be reached.",
+"type": "string"
+},
+"phone": {
+"$ref": "PhoneNumber",
+"description": "Optional. The phone number where customer service may be called."
+},
+"uri": {
+"description": "Optional. The URI where customer service may be found.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"CutoffConfig": {
+"description": "Configs related to local delivery ends for the day.",
+"id": "CutoffConfig",
+"properties": {
+"localCutoffTime": {
+"$ref": "LocalCutoffTime",
+"description": "Time that local delivery ends for the day."
+},
+"noDeliveryPostCutoff": {
+"description": "Businesses can opt-out of showing n+1 day local delivery when they have a shipping service configured to n day local delivery. For example, if the shipping service defines same-day delivery, and it's past the cut-off, setting this field to `true` results in the calculated shipping service rate returning `NO_DELIVERY_POST_CUTOFF`. In the same example, setting this field to `false` results in the calculated shipping time being one day. This is only for local delivery.",
+"type": "boolean"
+},
+"storeCloseOffsetHours": {
+"description": "Only valid with local delivery fulfillment. Represents cutoff time as the number of hours before store closing. Mutually exclusive with `local_cutoff_time`.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"CutoffTime": {
+"description": "Business days cutoff time definition.",
+"id": "CutoffTime",
+"properties": {
+"hour": {
+"description": "Required. Hour of the cutoff time until which an order has to be placed to be processed in the same day.",
+"format": "int32",
+"type": "integer"
+},
+"minute": {
+"description": "Required. Minute of the cutoff time until which an order has to be placed to be processed in the same day.",
+"format": "int32",
+"type": "integer"
+},
+"timeZone": {
+"description": "Required. [Timezone identifier](https://developers.google.com/adwords/api/docs/appendix/codes-formats#timezone-ids) For example \"Europe/Zurich\".",
+"type": "string"
+}
+},
+"type": "object"
+},
+"Date": {
+"description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp",
+"id": "Date",
+"properties": {
+"day": {
+"description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.",
+"format": "int32",
+"type": "integer"
+},
+"month": {
+"description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.",
+"format": "int32",
+"type": "integer"
+},
+"year": {
+"description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
+"DeliveryTime": {
+"description": "Time spent in various aspects from order to the delivery of the product.",
+"id": "DeliveryTime",
+"properties": {
+"cutoffTime": {
+"$ref": "CutoffTime",
+"description": "Business days cutoff time definition. If not configured the cutoff time will be defaulted to 8AM PST."
+},
+"handlingBusinessDayConfig": {
+"$ref": "BusinessDayConfig",
+"description": "The business days during which orders can be handled. If not provided, Monday to Friday business days will be assumed."
+},
+"maxHandlingDays": {
+"description": "Maximum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. Must be greater than or equal to `min_handling_days`. 'min_handling_days' and 'max_handling_days' should be either set or not set at the same time.",
+"format": "int32",
+"type": "integer"
+},
+"maxTransitDays": {
+"description": "Maximum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Must be greater than or equal to `min_transit_days`.",
+"format": "int32",
+"type": "integer"
+},
+"minHandlingDays": {
+"description": "Minimum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. 'min_handling_days' and 'max_handling_days' should be either set or not set at the same time.",
+"format": "int32",
+"type": "integer"
+},
+"minTransitDays": {
+"description": "Minimum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Either `min_transit_days`, `max_transit_days` or `transit_time_table` must be set, but not both.",
+"format": "int32",
+"type": "integer"
+},
+"transitBusinessDayConfig": {
+"$ref": "BusinessDayConfig",
+"description": "The business days during which orders can be in-transit. If not provided, Monday to Friday business days will be assumed."
+},
+"transitTimeTable": {
+"$ref": "TransitTable",
+"description": "Transit time table, number of business days spent in transit based on row and column dimensions. Either `min_transit_days`, `max_transit_days` or `transit_time_table` can be set, but not both."
+},
+"warehouseBasedDeliveryTimes": {
+"description": "Optional. Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the settings of the selected carrier. When set, no other transit time related field in delivery time should be set.",
+"items": {
+"$ref": "WarehouseBasedDeliveryTime"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"DeveloperRegistration": {
+"description": "Represents a developer registration owned by a Merchant account.",
+"id": "DeveloperRegistration",
+"properties": {
+"gcpIds": {
+"description": "Output only. The GCP ids attached to this developer registration",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
+"name": {
+"description": "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.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"DisableProgramRequest": {
+"description": "Request message for the DisableProgram method.",
+"id": "DisableProgramRequest",
+"properties": {},
+"type": "object"
+},
+"Distance": {
+"description": "Maximum delivery radius. This is only required for the local delivery shipment type.",
+"id": "Distance",
+"properties": {
+"unit": {
+"description": "Unit can differ based on country, it is parameterized to include miles and kilometers.",
+"enum": [
+"UNIT_UNSPECIFIED",
+"MILES",
+"KILOMETERS"
+],
+"enumDescriptions": [
+"Unit unspecified",
+"Unit in miles",
+"Unit in kilometers"
+],
+"type": "string"
+},
+"value": {
+"description": "Integer value of distance.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"EmailPreferences": {
+"description": "The categories of notifications the user opted into / opted out of. The email preferences do not include mandatory announcements as users can't opt out of them.",
+"id": "EmailPreferences",
+"properties": {
+"name": {
+"description": "Identifier. The name of the EmailPreferences. The endpoint is only supported for the authenticated user.",
+"type": "string"
+},
+"newsAndTips": {
+"description": "Optional. Updates on new features, tips and best practices.",
+"enum": [
+"OPT_IN_STATE_UNSPECIFIED",
+"OPTED_OUT",
+"OPTED_IN",
+"UNCONFIRMED"
+],
+"enumDescriptions": [
+"Opt-in status is not specified.",
+"User has opted out of receiving this type of email.",
+"User has opted in to receiving this type of email.",
+"User has opted in to receiving this type of email and the confirmation email has been sent, but user has not yet confirmed the opt in (applies only to certain countries)."
+],
+"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",
+"properties": {},
+"type": "object"
+},
+"EnableProgramRequest": {
+"description": "Request message for the EnableProgram method.",
+"id": "EnableProgramRequest",
+"properties": {},
+"type": "object"
+},
+"FindLfpProvidersResponse": {
+"description": "Response message for the FindLfpProviders method.",
+"id": "FindLfpProvidersResponse",
+"properties": {
+"lfpProviders": {
+"description": "The LFP providers from the specified merchant in the specified country.",
+"items": {
+"$ref": "LfpProvider"
+},
+"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"
+},
+"GbpAccount": {
+"description": "Collection of information related to a Google Business Profile (GBP) account.",
+"id": "GbpAccount",
+"properties": {
+"gbpAccountId": {
+"description": "The id of the GBP account.",
+"type": "string"
+},
+"gbpAccountName": {
+"description": "The name of the Business Profile. For personal accounts: Email id of the owner. For Business accounts: Name of the Business Account.",
+"type": "string"
+},
+"listingCount": {
+"description": "Number of listings under this account.",
+"format": "int64",
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the GBP account. Format: `accounts/{account}/gbpAccount/{gbp_account}`",
+"type": "string"
+},
+"type": {
+"description": "The type of the Business Profile.",
+"enum": [
+"TYPE_UNSPECIFIED",
+"USER",
+"BUSINESS_ACCOUNT"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The GBP account is a user account.",
+"The GBP account is a business account."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"GeoTargetArea": {
+"description": "A list of geotargets that defines the region area.",
+"id": "GeoTargetArea",
+"properties": {
+"geotargetCriteriaIds": {
+"description": "Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (for example, state).",
+"items": {
+"format": "int64",
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"Handshake": {
+"description": "The current status of establishing of the service. (for example, pending approval or approved).",
+"id": "Handshake",
+"properties": {
+"actor": {
+"description": "Output only. The most recent account to modify the account service's `approval_status`.",
+"enum": [
+"ACTOR_UNSPECIFIED",
+"ACCOUNT",
+"OTHER_PARTY"
+],
+"enumDescriptions": [
+"Unspecified actor.",
+"The last change was done by the account who has this service.",
+"The last change was done by the other party who this service points to."
+],
+"readOnly": true,
+"type": "string"
+},
+"approvalState": {
+"description": "Output only. The approval state of this handshake.",
+"enum": [
+"APPROVAL_STATE_UNSPECIFIED",
+"PENDING",
+"ESTABLISHED",
+"REJECTED"
+],
+"enumDescriptions": [
+"Unspecified approval status.",
+"The service was proposed and is waiting to be confirmed.",
+"Both parties have confirmed the service.",
+"The service proposal was rejected."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"Headers": {
+"description": "A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `num_items`, `postal_code_group_names`, or `location` must be set.",
+"id": "Headers",
+"properties": {
+"locations": {
+"description": "Required. A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.",
+"items": {
+"$ref": "LocationIdSet"
+},
+"type": "array"
+},
+"numberOfItems": {
+"description": "Required. A list of inclusive number of items upper bounds. The last value can be `\"infinity\"`. For example `[\"10\", \"50\", \"infinity\"]` represents the headers \"<= 10 items\", \"<= 50 items\", and \"> 50 items\". Must be non-empty. Can only be set if all other fields are not set.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"postalCodeGroupNames": {
+"description": "Required. A list of postal group names. The last value can be `\"all other locations\"`. Example: `[\"zone 1\", \"zone 2\", \"all other locations\"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"prices": {
+"description": "Required. A list of inclusive order price upper bounds. The last price's value can be infinity by setting price amount_micros = -1. For example `[{\"amount_micros\": 10000000, \"currency_code\": \"USD\"}, {\"amount_micros\": 500000000, \"currency_code\": \"USD\"}, {\"amount_micros\": -1, \"currency_code\": \"USD\"}]` represents the headers \"<= $10\", \"<= $500\", and \"> $500\". All prices within a service must have the same currency. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.",
+"items": {
+"$ref": "Price"
+},
+"type": "array"
+},
+"weights": {
+"description": "Required. A list of inclusive order weight upper bounds. The last weight's value can be infinity by setting price amount_micros = -1. For example `[{\"amount_micros\": 10000000, \"unit\": \"kg\"}, {\"amount_micros\": 50000000, \"unit\": \"kg\"}, {\"amount_micros\": -1, \"unit\": \"kg\"}]` represents the headers \"<= 10kg\", \"<= 50kg\", and \"> 50kg\". All weights within a service must have the same unit. Must be non-empty. Must be positive except -1. Can only be set if all other fields are not set.",
+"items": {
+"$ref": "Weight"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"Homepage": {
+"description": "The `Homepage` message represents a business's store homepage within the system. A business's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the business to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).",
+"id": "Homepage",
+"properties": {
+"claimed": {
+"description": "Output only. Whether the homepage is claimed. See https://support.google.com/merchants/answer/176793.",
+"readOnly": true,
+"type": "boolean"
+},
+"name": {
+"description": "Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`",
+"type": "string"
+},
+"uri": {
+"description": "Required. The URI (typically a URL) of the store's homepage.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"IdentityAttribute": {
+"description": "All information related to an identity attribute.",
+"id": "IdentityAttribute",
+"properties": {
+"identityDeclaration": {
+"description": "Required. The declaration of identity for this attribute.",
+"enum": [
+"IDENTITY_DECLARATION_UNSPECIFIED",
+"SELF_IDENTIFIES_AS",
+"DOES_NOT_SELF_IDENTIFY_AS"
+],
+"enumDescriptions": [
+"Default value indicating that no selection was made.",
+"Indicates that the account identifies with the attribute.",
+"Indicates that the account does not identify with the attribute."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ImageImprovementsAccountLevelSettings": {
+"description": "Settings for the Automatic Image Improvements.",
+"id": "ImageImprovementsAccountLevelSettings",
+"properties": {
+"allowAutomaticImageImprovements": {
+"description": "Enables automatic image improvements.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"Impact": {
+"description": "The impact of the issue on a region.",
+"id": "Impact",
+"properties": {
+"regionCode": {
+"description": "The [CLDR region code](https://cldr.unicode.org/) where this issue applies.",
+"type": "string"
+},
+"severity": {
+"description": "The severity of the issue on the destination and region.",
+"enum": [
+"SEVERITY_UNSPECIFIED",
+"CRITICAL",
+"ERROR",
+"SUGGESTION"
+],
+"enumDescriptions": [
+"The severity is unknown.",
+"The issue causes offers to not serve.",
+"The issue might affect offers (in the future) or might be an indicator of issues with offers.",
+"The issue is a suggestion for improvement."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ImpactedDestination": {
+"description": "The impact of the issue on a destination.",
+"id": "ImpactedDestination",
+"properties": {
+"impacts": {
+"description": "The (negative) impact for various regions on the given destination.",
+"items": {
+"$ref": "Impact"
+},
+"type": "array"
+},
+"reportingContext": {
+"description": "The impacted reporting context.",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"InStock": {
+"description": "Collection of information related to InStock.",
+"id": "InStock",
+"properties": {
+"state": {
+"description": "Output only. The state of the in-stock serving.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ACTIVE",
+"FAILED",
+"RUNNING",
+"ACTION_REQUIRED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The review process has concluded successfully. The reviewed item is active.",
+"The review process failed.",
+"The review process is running.",
+"The review process is waiting for the merchant to take action."
+],
+"readOnly": true,
+"type": "string"
+},
+"uri": {
+"description": "Optional. Product landing page URI. It is only used for the review of MHLSF in-stock serving. This URI domain should match with the business's homepage. Required to be empty if the lsf_type is GHLSF, and required when the lsf_type is MHLSF_FULL or MHLSF_BASIC.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"InventoryVerification": {
+"description": "Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC).",
+"id": "InventoryVerification",
+"properties": {
+"contact": {
+"description": "Required. The name of the contact for the inventory verification process.",
+"type": "string"
+},
+"contactEmail": {
+"description": "Required. The email address of the contact for the inventory verification process.",
+"type": "string"
+},
+"contactState": {
+"description": "Output only. The state of the contact verification.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ACTIVE",
+"FAILED",
+"RUNNING",
+"ACTION_REQUIRED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The review process has concluded successfully. The reviewed item is active.",
+"The review process failed.",
+"The review process is running.",
+"The review process is waiting for the merchant to take action."
+],
+"readOnly": true,
+"type": "string"
+},
+"state": {
+"description": "Output only. The state of the inventory verification process.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ACTION_REQUIRED",
+"INACTIVE",
+"RUNNING",
+"SUCCEEDED",
+"SUSPENDED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"When the merchant needs to initiate the inventory verification process. The next state is INACTIVE.",
+"When the merchant is ready to request inventory verification.",
+"The inventory verification process is running. If the merchant is rejected, the next state is INACTIVE.",
+"The inventory verification process succeeded.",
+"When merchant fails the inventory verification process and all attempts are exhausted."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"ItemUpdatesAccountLevelSettings": {
+"description": "Settings for the Automatic Item Updates.",
+"id": "ItemUpdatesAccountLevelSettings",
+"properties": {
+"allowAvailabilityUpdates": {
+"description": "If availability updates are enabled, any previous availability values get overwritten if Google finds an out-of-stock annotation on the offer's page. If additionally `allow_strict_availability_updates` field is set to true, values get overwritten if Google finds an in-stock annotation on the offer\u2019s page.",
+"type": "boolean"
+},
+"allowConditionUpdates": {
+"description": "If condition updates are enabled, Google always updates item condition with the condition detected from the details of your product.",
+"type": "boolean"
+},
+"allowPriceUpdates": {
+"description": "If price updates are enabled, Google always updates the active price with the crawled information.",
+"type": "boolean"
+},
+"allowStrictAvailabilityUpdates": {
+"description": "If `allow_availability_updates` is enabled, items are automatically updated in all your Shopping target countries. By default, availability updates will only be applied to items that are 'out of stock' on your website but 'in stock' on Shopping. Set this to true to also update items that are 'in stock' on your website, but 'out of stock' on Google Shopping. In order for this field to have an effect, you must also set `allow_availability_updates`.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"LfpLink": {
+"description": "Collection of information related to the LFP link.",
+"id": "LfpLink",
+"properties": {
+"externalAccountId": {
+"description": "Required. The account ID by which this merchant is known to the LFP provider.",
+"type": "string"
+},
+"lfpProvider": {
+"description": "Required. The resource name of the LFP provider. Format: `lfpProviders/{lfp_provider}`",
+"type": "string"
+},
+"state": {
+"description": "Output only. The state of the LFP link.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ACTIVE",
+"FAILED",
+"RUNNING",
+"ACTION_REQUIRED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The review process has concluded successfully. The reviewed item is active.",
+"The review process failed.",
+"The review process is running.",
+"The review process is waiting for the merchant to take action."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"LfpProvider": {
+"description": "Collection of information related to a Local Feed Partnership (LFP) provider.",
+"id": "LfpProvider",
+"properties": {
+"displayName": {
+"description": "The display name of the LFP provider.",
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the LFP provider. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}`",
+"type": "string"
+},
+"regionCode": {
+"description": "Output only. Region code defined by [CLDR](https://cldr.unicode.org/).",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"LinkGbpAccountRequest": {
+"description": "Request message for the LinkGbpAccount method.",
+"id": "LinkGbpAccountRequest",
+"properties": {
+"gbpEmail": {
+"description": "Required. The email address of the Business Profile account.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"LinkGbpAccountResponse": {
+"description": "Response message for the LinkGbpAccount method.",
+"id": "LinkGbpAccountResponse",
+"properties": {
+"response": {
+"$ref": "Empty",
+"description": "Empty response."
+}
+},
+"type": "object"
+},
+"LinkLfpProviderRequest": {
+"description": "Request message for the LinkLfpProvider method.",
+"id": "LinkLfpProviderRequest",
+"properties": {
+"externalAccountId": {
+"description": "Required. The external account ID by which this merchant is known to the LFP provider.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"LinkLfpProviderResponse": {
+"description": "Response message for the LinkLfpProvider method.",
+"id": "LinkLfpProviderResponse",
+"properties": {
+"response": {
+"$ref": "Empty",
+"description": "Empty response."
+}
+},
+"type": "object"
+},
+"ListAccountIssuesResponse": {
+"description": "Response message for the `ListAccountIssues` method.",
+"id": "ListAccountIssuesResponse",
+"properties": {
+"accountIssues": {
+"description": "The issues from the specified account.",
+"items": {
+"$ref": "AccountIssue"
+},
+"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"
+},
+"ListAccountRelationshipsResponse": {
+"description": "Response after trying to list account relationships.",
+"id": "ListAccountRelationshipsResponse",
+"properties": {
+"accountRelationships": {
+"description": "The account relationships that match your filter.",
+"items": {
+"$ref": "AccountRelationship"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "A page token. You can send the `page_token` to get the next page. Only included in the `list` response if there are more pages.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ListAccountServicesResponse": {
+"description": "Response after trying to list account services.",
+"id": "ListAccountServicesResponse",
+"properties": {
+"accountServices": {
+"description": "The account services that match your filter.",
+"items": {
+"$ref": "AccountService"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "A page token. You can send the `page_token` to get the next page. Only included in the `list` response if there are more pages.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ListAccountsResponse": {
+"description": "Response message for the `accounts.list` method.",
+"id": "ListAccountsResponse",
+"properties": {
+"accounts": {
+"description": "The accounts matching the `ListAccountsRequest`.",
+"items": {
+"$ref": "Account"
+},
+"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"
+},
+"ListGbpAccountsResponse": {
+"description": "Response message for the ListGbpAccounts method.",
+"id": "ListGbpAccountsResponse",
+"properties": {
+"gbpAccounts": {
+"description": "The GBP accounts from the specified merchant in the specified country.",
+"items": {
+"$ref": "GbpAccount"
+},
+"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"
+},
+"ListOmnichannelSettingsResponse": {
+"description": "Response message for the ListOmnichannelSettings method.",
+"id": "ListOmnichannelSettingsResponse",
+"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"
+},
+"omnichannelSettings": {
+"description": "The omnichannel settings from the specified merchant.",
+"items": {
+"$ref": "OmnichannelSetting"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"ListOnlineReturnPoliciesResponse": {
+"description": "Response message for the `ListOnlineReturnPolicies` method.",
+"id": "ListOnlineReturnPoliciesResponse",
+"properties": {
+"nextPageToken": {
+"description": "A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
+"type": "string"
+},
+"onlineReturnPolicies": {
+"description": "The retrieved return policies.",
+"items": {
+"$ref": "OnlineReturnPolicy"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"ListProgramsResponse": {
+"description": "Response message for the ListPrograms method.",
+"id": "ListProgramsResponse",
+"properties": {
+"nextPageToken": {
+"description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
+"type": "string"
+},
+"programs": {
+"description": "The programs for the given account.",
+"items": {
+"$ref": "Program"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"ListRegionsResponse": {
+"description": "Response message for the `ListRegions` method.",
+"id": "ListRegionsResponse",
+"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"
+},
+"regions": {
+"description": "The regions from the specified business.",
+"items": {
+"$ref": "Region"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"ListSubAccountsResponse": {
+"description": "Response message for the `ListSubAccounts` method.",
+"id": "ListSubAccountsResponse",
+"properties": {
+"accounts": {
+"description": "The accounts for which the given parent account is an aggregator.",
+"items": {
+"$ref": "Account"
+},
+"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"
+},
+"ListUsersResponse": {
+"description": "Response message for the `ListUsers` method.",
+"id": "ListUsersResponse",
+"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"
+},
+"users": {
+"description": "The users from the specified account.",
+"items": {
+"$ref": "User"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"LocalCutoffTime": {
+"description": "Time that local delivery ends for the day.",
+"id": "LocalCutoffTime",
+"properties": {
+"hour": {
+"description": "Hour local delivery orders must be placed by to process the same day.",
+"format": "int64",
+"type": "string"
+},
+"minute": {
+"description": "Minute local delivery orders must be placed by to process the same day.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"LocalListingManagement": {
+"description": "`LocalListingManagement` payload.",
+"id": "LocalListingManagement",
+"properties": {},
+"type": "object"
+},
+"LocationIdSet": {
+"description": "A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.",
+"id": "LocationIdSet",
+"properties": {
+"locationIds": {
+"description": "Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (For example, state).",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"LoyaltyProgram": {
+"description": "[Loyalty program](https://support.google.com/merchants/answer/12922446) provided by a business.",
+"id": "LoyaltyProgram",
+"properties": {
+"loyaltyProgramTiers": {
+"description": "Optional. Loyalty program tier of this shipping service.",
+"items": {
+"$ref": "LoyaltyProgramTiers"
+},
+"type": "array"
+},
+"programLabel": {
+"description": "This is the loyalty program label set in your loyalty program settings in Merchant Center. This sub-attribute allows Google to map your loyalty program to eligible offers.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"LoyaltyProgramTiers": {
+"description": "Subset of a business's loyalty program.",
+"id": "LoyaltyProgramTiers",
+"properties": {
+"tierLabel": {
+"description": "The tier label [tier_label] sub-attribute differentiates offer level benefits between each tier. This value is also set in your program settings in Merchant Center, and is required for data source changes even if your loyalty program only has 1 tier.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"MinimumOrderValueTable": {
+"description": "Table of per store minimum order values for the pickup fulfillment type.",
+"id": "MinimumOrderValueTable",
+"properties": {
+"storeCodeSetWithMovs": {
+"description": "Required. A list of store code sets sharing the same minimum order value (MOV). At least two sets are required and the last one must be empty, which signifies 'MOV for all other stores'. Each store code can only appear once across all the sets. All prices within a service must have the same currency.",
+"items": {
+"$ref": "StoreCodeSetWithMov"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"OmnichannelSetting": {
+"description": "Collection of information related to the omnichannel settings of a merchant.",
+"id": "OmnichannelSetting",
+"properties": {
+"about": {
+"$ref": "About",
+"description": "Optional. The about page URI and state for this country."
+},
+"inStock": {
+"$ref": "InStock",
+"description": "Optional. The InStock URI and state for this country."
+},
+"inventoryVerification": {
+"$ref": "InventoryVerification",
+"description": "Optional. The inventory verification contact and state for this country."
+},
+"lfpLink": {
+"$ref": "LfpLink",
+"description": "Output only. The established link to a LFP provider.",
+"readOnly": true
+},
+"lsfType": {
+"description": "Required. The Local Store Front type for this country.",
+"enum": [
+"LSF_TYPE_UNSPECIFIED",
+"GHLSF",
+"MHLSF_BASIC",
+"MHLSF_FULL"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Google-Hosted Local Store Front. Check the [HC article](https://support.google.com/merchants/answer/14869424) for more details.",
+"Merchant-Hosted Local Store Front Basic. Check the [HC article](https://support.google.com/merchants/answer/14615867) for more details.",
+"Merchant-Hosted Local Store Front Full. Check the [HC article](https://support.google.com/merchants/answer/14617076) for more details."
+],
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the omnichannel setting. Format: `accounts/{account}/omnichannelSettings/{omnichannel_setting}`",
+"type": "string"
+},
+"odo": {
+"$ref": "OnDisplayToOrder",
+"description": "Optional. The On Display to Order (ODO) policy URI and state for this country."
+},
+"pickup": {
+"$ref": "Pickup",
+"description": "Optional. The Pickup URI and state for this country."
+},
+"regionCode": {
+"description": "Required. Immutable. Region code defined by [CLDR](https://cldr.unicode.org/). Must be provided in the Create method, and is immutable.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"OnDisplayToOrder": {
+"description": "Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)).",
+"id": "OnDisplayToOrder",
+"properties": {
+"state": {
+"description": "Output only. The state of the URI.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ACTIVE",
+"FAILED",
+"RUNNING",
+"ACTION_REQUIRED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The review process has concluded successfully. The reviewed item is active.",
+"The review process failed.",
+"The review process is running.",
+"The review process is waiting for the merchant to take action."
+],
+"readOnly": true,
+"type": "string"
+},
+"uri": {
+"description": "Required. The on display to order (ODO) policy URI.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"OnlineReturnPolicy": {
+"description": "[Online return policy](https://support.google.com/merchants/answer/10220642) object. This is currently used to represent return policies for ads and free listings programs.",
+"id": "OnlineReturnPolicy",
+"properties": {
+"acceptDefectiveOnly": {
+"description": "Optional. This field specifies if business only accepts defective products for returns.",
+"type": "boolean"
+},
+"acceptExchange": {
+"description": "Optional. This field specifies if business allows customers to exchange products.",
+"type": "boolean"
+},
+"countries": {
+"description": "Required. Immutable. The countries of sale where the return policy applies. The values must be a valid 2 letter ISO 3166 code.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"itemConditions": {
+"description": "Optional. The item conditions accepted for returns must not be empty unless the type of return policy is 'noReturns'.",
+"items": {
+"enum": [
+"ITEM_CONDITION_UNSPECIFIED",
+"NEW",
+"USED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"New.",
+"Used."
+],
+"type": "string"
+},
+"type": "array"
+},
+"label": {
+"description": "Optional. Immutable. This field represents the unique user-defined label of the return policy for the given country. It is important to note that the same label cannot be used in different return policies for the same country. If not given, policies will be automatically treated as the 'default' for the country. When using label, you are creating an exception policy in that country to assign a custom return policy to certain product groups, follow the instructions provided in the [Return policy label] (https://support.google.com/merchants/answer/9445425). The label can contain up to 50 characters.",
+"type": "string"
+},
+"name": {
+"description": "Identifier. The name of the `OnlineReturnPolicy` resource. Format: `accounts/{account}/onlineReturnPolicies/{return_policy}`",
+"type": "string"
+},
+"policy": {
+"$ref": "Policy",
+"description": "Optional. The return policy."
+},
+"processRefundDays": {
+"description": "Optional. The field specifies the number of days it takes for business to process refunds.",
+"format": "int32",
+"type": "integer"
+},
+"restockingFee": {
+"$ref": "RestockingFee",
+"description": "Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set."
+},
+"returnLabelSource": {
+"description": "Optional. The field specifies the return label source.",
+"enum": [
+"RETURN_LABEL_SOURCE_UNSPECIFIED",
+"DOWNLOAD_AND_PRINT",
+"IN_THE_PACKAGE",
+"CUSTOMER_RESPONSIBILITY"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Download and print.",
+"Label include in the package.",
+"Customer to provide."
+],
+"type": "string"
+},
+"returnMethods": {
+"description": "Optional. The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns.",
+"items": {
+"enum": [
+"RETURN_METHOD_UNSPECIFIED",
+"BY_MAIL",
+"IN_STORE",
+"AT_A_KIOSK"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Return by mail.",
+"Return in store.",
+"Return at a kiosk."
+],
+"type": "string"
+},
+"type": "array"
+},
+"returnPolicyId": {
+"description": "Output only. Return policy ID generated by Google.",
+"readOnly": true,
+"type": "string"
+},
+"returnPolicyUri": {
+"description": "Required. The return policy uri. This can used by Google to do a sanity check for the policy. It must be a valid URL.",
+"type": "string"
+},
+"returnShippingFee": {
+"$ref": "ReturnShippingFee",
+"description": "Optional. The return shipping fee. Should be set only when customer need to download and print the return label."
+},
+"seasonalOverrides": {
+"description": "Optional. Overrides to the general policy for orders placed during a specific set of time intervals.",
+"items": {
+"$ref": "SeasonalOverride"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"PhoneNumber": {
+"description": "An object representing a phone number, suitable as an API wire format. This representation: - should not be used for locale-specific formatting of a phone number, such as \"+1 (650) 253-0000 ext. 123\" - is not designed for efficient storage - may not be suitable for dialing - specialized libraries (see references) should be used to parse the number for that purpose To do something meaningful with this number, such as format it for various use-cases, convert it to an `i18n.phonenumbers.PhoneNumber` object first. For instance, in Java this would be: com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), \"ZZ\"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); } Reference(s): - https://github.com/google/libphonenumber",
+"id": "PhoneNumber",
+"properties": {
+"e164Number": {
+"description": "The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: \"+15552220123\" - incorrect: \"+1 (555) 222-01234 x123\" The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes",
+"type": "string"
+},
+"extension": {
+"description": "The phone number's extension. The extension is not standardized in ITU recommendations, except for being defined as a series of numbers with a maximum length of 40 digits. Other than digits, some other dialing characters such as ',' (indicating a wait) or '#' may be stored here. Note that no regions currently use extensions with short codes, so this field is normally only set in conjunction with an E.164 number. It is held separately from the E.164 number to allow for short code extensions in the future.",
+"type": "string"
+},
+"shortCode": {
+"$ref": "ShortCode",
+"description": "A short code. Reference(s): - https://wikipedia.org/wiki/Short_code"
+}
+},
+"type": "object"
+},
+"Pickup": {
+"description": "Collection of information related to Pickup.",
+"id": "Pickup",
+"properties": {
+"state": {
+"description": "Output only. The state of the pickup serving.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ACTIVE",
+"FAILED",
+"RUNNING",
+"ACTION_REQUIRED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The review process has concluded successfully. The reviewed item is active.",
+"The review process failed.",
+"The review process is running.",
+"The review process is waiting for the merchant to take action."
+],
+"readOnly": true,
+"type": "string"
+},
+"uri": {
+"description": "Required. Pickup product page URI. It is only used for the review of pickup serving. This URI domain should match with the business's homepage.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"Policy": {
+"description": "The available policies.",
+"id": "Policy",
+"properties": {
+"days": {
+"description": "The number of days items can be returned after delivery, where one day is defined as 24 hours after the delivery timestamp. Required for `NUMBER_OF_DAYS_AFTER_DELIVERY` returns.",
+"format": "int64",
+"type": "string"
+},
+"type": {
+"description": "Policy type.",
+"enum": [
+"TYPE_UNSPECIFIED",
+"NUMBER_OF_DAYS_AFTER_DELIVERY",
+"NO_RETURNS",
+"LIFETIME_RETURNS"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The number of days within which a return is valid after delivery.",
+"No returns.",
+"Life time returns."
+],
+"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",
+"properties": {
+"addressLines": {
+"description": "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).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"administrativeArea": {
+"description": "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.",
+"type": "string"
+},
+"languageCode": {
+"description": "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\".",
+"type": "string"
+},
+"locality": {
+"description": "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`.",
+"type": "string"
+},
+"organization": {
+"description": "Optional. The name of the organization at the address.",
+"type": "string"
+},
+"postalCode": {
+"description": "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).",
+"type": "string"
+},
+"recipients": {
+"description": "Optional. The recipient at the address. This field may, under certain circumstances, contain multiline information. For example, it might contain \"care of\" information.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"regionCode": {
+"description": "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.",
+"type": "string"
+},
+"revision": {
+"description": "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.",
+"format": "int32",
+"type": "integer"
+},
+"sortingCode": {
+"description": "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\u00f4te d'Ivoire).",
+"type": "string"
+},
+"sublocality": {
+"description": "Optional. Sublocality of the address. For example, this can be a neighborhood, borough, or district.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"PostalCodeArea": {
+"description": "A list of postal codes that defines the region area. Note: All regions defined using postal codes are accessible through the account's `ShippingSettings.postalCodeGroups` resource.",
+"id": "PostalCodeArea",
+"properties": {
+"postalCodes": {
+"description": "Required. A range of postal codes.",
+"items": {
+"$ref": "PostalCodeRange"
+},
+"type": "array"
+},
+"regionCode": {
+"description": "Required. [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) or the country the postal code group applies to.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"PostalCodeRange": {
+"description": "A range of postal codes that defines the region area.",
+"id": "PostalCodeRange",
+"properties": {
+"begin": {
+"description": "Required. A postal code or a pattern of the form prefix* denoting the inclusive lower bound of the range defining the area. Examples values: `94108`, `9410*`, `9*`.",
+"type": "string"
+},
+"end": {
+"description": "Optional. A postal code or a pattern of the form `prefix*` denoting the inclusive upper bound of the range defining the area. It must have the same length as postalCodeRangeBegin: if postalCodeRangeBegin is a postal code then postalCodeRangeEnd must be a postal code too; if postalCodeRangeBegin is a pattern then postalCodeRangeEnd must be a pattern with the same prefix length. Optional: if not set, then the area is defined as being all the postal codes matching postalCodeRangeBegin.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"Price": {
+"description": "The price represented as a number and currency.",
+"id": "Price",
+"properties": {
+"amountMicros": {
+"description": "The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).",
+"format": "int64",
+"type": "string"
+},
+"currencyCode": {
+"description": "The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductChange": {
+"description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.",
+"id": "ProductChange",
+"properties": {
+"newValue": {
+"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"oldValue": {
+"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"regionCode": {
+"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
+"type": "string"
+},
+"reportingContext": {
+"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductStatusChangeMessage": {
+"description": "The message that the merchant will receive to notify about product status change event",
+"id": "ProductStatusChangeMessage",
+"properties": {
+"account": {
+"description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`",
+"type": "string"
+},
+"attribute": {
+"description": "The attribute in the resource that changed, in this case it will be always `Status`.",
+"enum": [
+"ATTRIBUTE_UNSPECIFIED",
+"STATUS"
+],
+"enumDescriptions": [
+"Unspecified attribute",
+"Status of the changed entity"
+],
+"type": "string"
+},
+"changes": {
+"description": "A message to describe the change that happened to the product",
+"items": {
+"$ref": "ProductChange"
+},
+"type": "array"
+},
+"eventTime": {
+"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationTime": {
+"description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.",
+"format": "google-datetime",
+"type": "string"
+},
+"managingAccount": {
+"description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`",
+"type": "string"
+},
+"resource": {
+"description": "The product name. Format: `accounts/{account}/products/{product}`",
+"type": "string"
+},
+"resourceId": {
+"description": "The product id.",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource that changed, in this case it will always be `Product`.",
+"enum": [
+"RESOURCE_UNSPECIFIED",
+"PRODUCT"
+],
+"enumDescriptions": [
+"Unspecified resource",
+"Resource type : product"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductsManagement": {
+"description": "`ProductsManagement` payload.",
+"id": "ProductsManagement",
+"properties": {},
+"type": "object"
+},
+"Program": {
+"description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`",
+"id": "Program",
+"properties": {
+"activeRegionCodes": {
+"description": "Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally.",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
+"documentationUri": {
+"description": "Output only. The URL of a Merchant Center help page describing the program.",
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the program. Format: `accounts/{account}/programs/{program}`",
+"type": "string"
+},
+"state": {
+"description": "Output only. The participation state of the account in the program.",
+"enum": [
+"STATE_UNSPECIFIED",
+"NOT_ELIGIBLE",
+"ELIGIBLE",
+"ENABLED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The account is not eligible to participate in the program.",
+"The account is eligible to participate in the program.",
+"The program is enabled for the account."
+],
+"readOnly": true,
+"type": "string"
+},
+"unmetRequirements": {
+"description": "Output only. The requirements that the account has not yet satisfied that are affecting participation in the program.",
+"items": {
+"$ref": "Requirement"
+},
+"readOnly": true,
+"type": "array"
+}
+},
+"type": "object"
+},
+"ProposeAccountServiceRequest": {
+"description": "Request to propose an account service.",
+"id": "ProposeAccountServiceRequest",
+"properties": {
+"accountService": {
+"$ref": "AccountService",
+"description": "Required. The account service to propose."
+},
+"provider": {
+"description": "Required. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"RateGroup": {
+"description": "Shipping rate group definitions. Only the last one is allowed to have an empty `applicable_shipping_labels`, which means \"everything else\". The other `applicable_shipping_labels` must not overlap.",
+"id": "RateGroup",
+"properties": {
+"applicableShippingLabels": {
+"description": "Required. A list of [shipping labels](https://support.google.com/merchants/answer/6324504) defining the products to which this rate group applies to. This is a disjunction: only one of the labels has to match for the rate group to apply. May only be empty for the last rate group of a service.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"carrierRates": {
+"description": "Optional. A list of carrier rates that can be referred to by `main_table` or `single_value`.",
+"items": {
+"$ref": "CarrierRate"
+},
+"type": "array"
+},
+"mainTable": {
+"$ref": "Table",
+"description": "A table defining the rate group, when `single_value` is not expressive enough. Can only be set if `single_value` is not set."
+},
+"name": {
+"description": "Optional. Name of the rate group. If set has to be unique within shipping service.",
+"type": "string"
+},
+"singleValue": {
+"$ref": "Value",
+"description": "The value of the rate group (For example flat rate $10). Can only be set if `main_table` and `subtables` are not set."
+},
+"subtables": {
+"description": "Optional. A list of subtables referred to by `main_table`. Can only be set if `main_table` is set.",
+"items": {
+"$ref": "Table"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"Region": {
+"description": "Represents a geographic region that you can use as a target with both the `RegionalInventory` and `ShippingSettings` services. You can define regions as collections of either postal codes or, in some countries, using predefined geotargets. For more information, see [Set up regions ](https://support.google.com/merchants/answer/7410946#zippy=%2Ccreate-a-new-region) for more information.",
+"id": "Region",
+"properties": {
+"displayName": {
+"description": "Optional. The display name of the region.",
+"type": "string"
+},
+"geotargetArea": {
+"$ref": "GeoTargetArea",
+"description": "Optional. A list of geotargets that defines the region area."
+},
+"name": {
+"description": "Identifier. The resource name of the region. Format: `accounts/{account}/regions/{region}`",
+"type": "string"
+},
+"postalCodeArea": {
+"$ref": "PostalCodeArea",
+"description": "Optional. A list of postal codes that defines the region area."
+},
+"regionalInventoryEligible": {
+"description": "Output only. Indicates if the region is eligible for use in the Regional Inventory configuration.",
+"readOnly": true,
+"type": "boolean"
+},
+"shippingEligible": {
+"description": "Output only. Indicates if the region is eligible for use in the Shipping Services configuration.",
+"readOnly": true,
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"RegisterGcpRequest": {
+"description": "Request message for the RegisterGCP method.",
+"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",
+"type": "string"
+}
+},
+"type": "object"
+},
+"RejectAccountServiceRequest": {
+"description": "Request to reject an account service.",
+"id": "RejectAccountServiceRequest",
+"properties": {},
+"type": "object"
+},
+"RequestInventoryVerificationRequest": {
+"description": "Request message for the RequestInventoryVerification method.",
+"id": "RequestInventoryVerificationRequest",
+"properties": {},
+"type": "object"
+},
+"RequestInventoryVerificationResponse": {
+"description": "Response message for the RequestInventoryVerification method.",
+"id": "RequestInventoryVerificationResponse",
+"properties": {
+"omnichannelSetting": {
+"$ref": "OmnichannelSetting",
+"description": "The omnichannel setting that was updated."
+}
+},
+"type": "object"
+},
+"Required": {
+"description": "Describes the terms of service which are required to be accepted.",
+"id": "Required",
+"properties": {
+"termsOfService": {
+"description": "Required. The `TermsOfService` that need to be accepted.",
+"type": "string"
+},
+"tosFileUri": {
+"description": "Required. Full URL to the terms of service file. This field is the same as `TermsOfService.file_uri`, it is added here for convenience only.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"Requirement": {
+"description": "Defines a requirement specified for participation in the program.",
+"id": "Requirement",
+"properties": {
+"affectedRegionCodes": {
+"description": "Output only. The regions that are currently affected by this requirement not being met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally.",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
+"documentationUri": {
+"description": "Output only. The URL of a help page describing the requirement.",
+"readOnly": true,
+"type": "string"
+},
+"title": {
+"description": "Output only. Name of the requirement.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"RestockingFee": {
+"description": "The restocking fee. This can be a flat fee or a micro percent.",
+"id": "RestockingFee",
+"properties": {
+"fixedFee": {
+"$ref": "Price",
+"description": "Fixed restocking fee."
+},
+"microPercent": {
+"description": "Percent of total price in micros. 15,000,000 means 15% of the total price would be charged.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
+"ReturnShippingFee": {
+"description": "The return shipping fee. This can either be a fixed fee or a boolean to indicate that the customer pays the actual shipping cost.",
+"id": "ReturnShippingFee",
+"properties": {
+"fixedFee": {
+"$ref": "Price",
+"description": "Fixed return shipping fee amount. This value is only applicable when type is `FIXED`. We will treat the return shipping fee as free if type is `FIXED` and this value is not set."
+},
+"type": {
+"description": "Required. Type of return shipping fee.",
+"enum": [
+"TYPE_UNSPECIFIED",
+"FIXED",
+"CUSTOMER_PAYING_ACTUAL_FEE"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The return shipping fee is a fixed value.",
+"Customers will pay the actual return shipping fee."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"Row": {
+"description": "Include a list of cells.",
+"id": "Row",
+"properties": {
+"cells": {
+"description": "Required. The list of cells that constitute the row. Must have the same length as `columnHeaders` for two-dimensional tables, a length of 1 for one-dimensional tables.",
+"items": {
+"$ref": "Value"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"SeasonalOverride": {
+"id": "SeasonalOverride",
+"properties": {
+"endDate": {
+"$ref": "Date",
+"description": "Required. seasonal override end date (inclusive)."
+},
+"label": {
+"description": "Required. Display name of this seasonal override in Merchant Center.",
+"type": "string"
+},
+"returnDays": {
+"description": "Number of days (from the delivery date) that the product can be returned.",
+"format": "int32",
+"type": "integer"
+},
+"returnUntilDate": {
+"$ref": "Date",
+"description": "Fixed end date until which the product can be returned."
+},
+"startDate": {
+"$ref": "Date",
+"description": "Required. Defines the date range when this seasonal override applies. Both start_date and end_date are inclusive. The dates of the seasonal overrides should not overlap."
+}
+},
+"type": "object"
+},
+"Service": {
+"description": "Shipping service.",
+"id": "Service",
+"properties": {
+"active": {
+"description": "Required. A boolean exposing the active status of the shipping service.",
+"type": "boolean"
+},
+"currencyCode": {
+"description": "Required. The CLDR code of the currency to which this service applies. Must match that of the prices in rate groups.",
+"type": "string"
+},
+"deliveryCountries": {
+"description": "Required. The CLDR territory code of the countries to which the service applies.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"deliveryTime": {
+"$ref": "DeliveryTime",
+"description": "Required. Time spent in various aspects from order to the delivery of the product."
+},
+"loyaltyPrograms": {
+"description": "Optional. Loyalty programs that this shipping service is limited to.",
+"items": {
+"$ref": "LoyaltyProgram"
+},
+"type": "array"
+},
+"minimumOrderValue": {
+"$ref": "Price",
+"description": "Optional. Minimum order value for this service. If set, indicates that customers will have to spend at least this amount. All prices within a service must have the same currency. Cannot be set together with `minimum_order_value_table`."
+},
+"minimumOrderValueTable": {
+"$ref": "MinimumOrderValueTable",
+"description": "Optional. Table of per store minimum order values for the pickup fulfillment type. Cannot be set together with `minimum_order_value`."
+},
+"rateGroups": {
+"description": "Optional. Shipping rate group definitions. Only the last one is allowed to have an empty `applicable_shipping_labels`, which means \"everything else\". The other `applicable_shipping_labels` must not overlap.",
+"items": {
+"$ref": "RateGroup"
+},
+"type": "array"
+},
+"serviceName": {
+"description": "Required. Free-form name of the service. Must be unique within target account.",
+"type": "string"
+},
+"shipmentType": {
+"description": "Optional. Type of locations this service ships orders to.",
+"enum": [
+"SHIPMENT_TYPE_UNSPECIFIED",
+"DELIVERY",
+"LOCAL_DELIVERY",
+"COLLECTION_POINT"
+],
+"enumDescriptions": [
+"This service did not specify shipment type.",
+"This service ships orders to an address chosen by the customer.",
+"This service ships orders to an address chosen by the customer. The order is shipped from a local store near by.",
+"This service ships orders to an address chosen by the customer. The order is shipped from a collection point."
+],
+"type": "string"
+},
+"storeConfig": {
+"$ref": "StoreConfig",
+"description": "A list of stores your products are delivered from. This is only valid for the local delivery shipment type."
+}
+},
+"type": "object"
+},
+"ShippingSettings": {
+"description": "The Merchant Center account's [shipping settings](https://support.google.com/merchants/answer/6069284). The `ShippingSettings` resource lets you retrieve and update the shipping settings of your advanced account and all its associated sub-accounts.",
+"id": "ShippingSettings",
+"properties": {
+"etag": {
+"description": "Required. This field helps avoid async issues. It ensures that the shipping setting data doesn't change between the `get` call and the `insert` call. The user should follow these steps: 1. Set the etag field as an empty string for the initial shipping setting creation. 2. After the initial creation, call the `get` method to obtain an etag and the current shipping setting data before calling `insert`. 3. Modify the shipping setting information. 4. Call the `insert` method with the shipping setting information and the etag obtained in step 2. 5. If the shipping setting data changes between step 2 and step 4, the insert request will fail because the etag changes every time the shipping setting data changes. In this case, the user should repeat steps 2-4 with the new etag.",
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the shipping settings. Format: `accounts/{account}/shippingSettings`. For example, `accounts/123456/shippingSettings`.",
+"type": "string"
+},
+"services": {
+"description": "Optional. The target account's list of services.",
+"items": {
+"$ref": "Service"
+},
+"type": "array"
+},
+"warehouses": {
+"description": "Optional. A list of warehouses which can be referred to in `services`.",
+"items": {
+"$ref": "Warehouse"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"ShortCode": {
+"description": "An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (For example \"Text 611 to see how many minutes you have remaining on your plan.\"). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (For example: US and CA).",
+"id": "ShortCode",
+"properties": {
+"number": {
+"description": "Required. The short code digits, without a leading plus ('+') or country calling code. For example \"611\".",
+"type": "string"
+},
+"regionCode": {
+"description": "Required. The BCP-47 region code of the location where calls to this short code can be made, such as \"US\" and \"BB\". Reference(s): - http://www.unicode.org/reports/tr35/#unicode_region_subtag",
+"type": "string"
+}
+},
+"type": "object"
+},
+"StoreCodeSetWithMov": {
+"description": "A list of store code sets sharing the same minimum order value. At least two sets are required and the last one must be empty, which signifies 'MOV for all other stores'. Each store code can only appear once across all the sets. All prices within a service must have the same currency.",
+"id": "StoreCodeSetWithMov",
+"properties": {
+"storeCodes": {
+"description": "Optional. A list of unique store codes or empty for the catch all.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"value": {
+"$ref": "Price",
+"description": "The minimum order value for the given stores."
+}
+},
+"type": "object"
+},
+"StoreConfig": {
+"description": "A list of stores your products are delivered from. This is only valid for the local delivery shipment type.",
+"id": "StoreConfig",
+"properties": {
+"cutoffConfig": {
+"$ref": "CutoffConfig",
+"description": "Configs related to local delivery ends for the day."
+},
+"serviceRadius": {
+"$ref": "Distance",
+"description": "Maximum delivery radius. This is only required for the local delivery shipment type."
+},
+"storeCodes": {
+"description": "Optional. A list of store codes that provide local delivery. If empty, then `all_stores` must be true.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"storeServiceType": {
+"description": "Indicates whether all stores, or selected stores, listed by this business provide local delivery.",
+"enum": [
+"STORE_SERVICE_TYPE_UNSPECIFIED",
+"ALL_STORES",
+"SELECTED_STORES"
+],
+"enumDescriptions": [
+"Did not specify store service type.",
+"Indicates whether all stores, current and future, listed by this business provide local delivery.",
+"Indicates that only the stores listed in `store_codes` are eligible for local delivery."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"Table": {
+"description": "A table defining the rate group, when `single_value` is not expressive enough.",
+"id": "Table",
+"properties": {
+"columnHeaders": {
+"$ref": "Headers",
+"description": "Headers of the table's columns. Optional: if not set then the table has only one dimension."
+},
+"name": {
+"description": "Name of the table. Required for subtables, ignored for the main table.",
+"type": "string"
+},
+"rowHeaders": {
+"$ref": "Headers",
+"description": "Required. Headers of the table's rows."
+},
+"rows": {
+"description": "Required. The list of rows that constitute the table. Must have the same length as `row_headers`.",
+"items": {
+"$ref": "Row"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"TermsOfService": {
+"description": "The `TermsOfService` message represents a specific version of the terms of service that merchants must accept to access certain features or services. For more information, see [Terms of Service](https://support.google.com/merchants/answer/160173). This message is important for the onboarding process, ensuring that merchants agree to the necessary legal agreements for using the service. Merchants can retrieve the latest terms of service for a given `kind` and `region` through `RetrieveLatestTermsOfService`, and accept them as required through `AcceptTermsOfService`.",
+"id": "TermsOfService",
+"properties": {
+"external": {
+"description": "Whether this terms of service version is external. External terms of service versions can only be agreed through external processes and not directly by the merchant through UI or API.",
+"type": "boolean"
+},
+"fileUri": {
+"description": "URI for terms of service file that needs to be displayed to signing users.",
+"type": "string"
+},
+"kind": {
+"description": "The Kind this terms of service version applies to.",
+"enum": [
+"TERMS_OF_SERVICE_KIND_UNSPECIFIED",
+"MERCHANT_CENTER"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Merchant Center application."
+],
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the terms of service version. Format: `termsOfService/{version}`",
+"type": "string"
+},
+"regionCode": {
+"description": "Region code as defined by [CLDR](https://cldr.unicode.org/). This is either a country where the ToS applies specifically to that country or `001` when the same `TermsOfService` can be signed in any country. However note that when signing a ToS that applies globally we still expect that a specific country is provided (this should be merchant business country or program country of participation).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"TermsOfServiceAgreementState": {
+"description": "This resource represents the agreement state for a given account and terms of service kind. The state is as follows: * If the business has accepted a terms of service, `accepted` will be populated, otherwise it will be empty * If the business must sign a terms of service, `required` will be populated, otherwise it will be empty. Note that both `required` and `accepted` can be present. In this case the `accepted` terms of services will have an expiration date set in the `valid_until` field. The `required` terms of services need to be accepted before `valid_until` in order for the account to continue having a valid agreement. When accepting new terms of services we expect third-party providers to display the text associated with the given terms of service agreement (the url to the file containing the text is added in the Required message below as `tos_file_uri`). The actual acceptance of the terms of service is done by calling accept on the `TermsOfService` resource. `valid_until` field. The `required` terms of services need to be accepted before `valid_until` in order for the account to continue having a valid agreement. When accepting new terms of services, we expect third-party providers to display the text associated with the given terms of service agreement (the url to the file containing the text is added in the Required message below as `tos_file_uri`. The actual acceptance of the terms of service is done by calling accept on the `TermsOfService` resource.",
+"id": "TermsOfServiceAgreementState",
+"properties": {
+"accepted": {
+"$ref": "Accepted",
+"description": "Optional. The accepted terms of service of this kind and for the associated region_code"
+},
+"name": {
+"description": "Identifier. The resource name of the terms of service version. Format: `accounts/{account}/termsOfServiceAgreementState/{identifier}` The identifier format is: `{TermsOfServiceKind}-{country}` For example, an identifier could be: `MERCHANT_CENTER-EU` or `MERCHANT_CENTER-US`.",
+"type": "string"
+},
+"regionCode": {
+"description": "Required. Region code as defined by https://cldr.unicode.org/. This is the country the current state applies to.",
+"type": "string"
+},
+"required": {
+"$ref": "Required",
+"description": "Optional. The required terms of service"
+},
+"termsOfServiceKind": {
+"description": "Required. Terms of Service kind associated with the particular version.",
+"enum": [
+"TERMS_OF_SERVICE_KIND_UNSPECIFIED",
+"MERCHANT_CENTER"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Merchant Center application."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"TimeZone": {
+"description": "Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones).",
+"id": "TimeZone",
+"properties": {
+"id": {
+"description": "IANA Time Zone Database time zone. For example \"America/New_York\".",
+"type": "string"
+},
+"version": {
+"description": "Optional. IANA Time Zone Database version number. For example \"2019a\".",
+"type": "string"
+}
+},
+"type": "object"
+},
+"TransitTable": {
+"description": "Transit time table, number of business days spent in transit based on row and column dimensions. Either `min_transit_days`, `max_transit_days` or `transit_time_table` can be set, but not both.",
+"id": "TransitTable",
+"properties": {
+"postalCodeGroupNames": {
+"description": "Required. A list of region names Region.name . The last value can be `\"all other locations\"`. Example: `[\"zone 1\", \"zone 2\", \"all other locations\"]`. The referred postal code groups must match the delivery country of the service.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"rows": {
+"description": "Required. If there's only one dimension set of `postal_code_group_names` or `transit_time_labels`, there are multiple rows each with one value for that dimension. If there are two dimensions, each row corresponds to a `postal_code_group_names`, and columns (values) to a `transit_time_labels`.",
+"items": {
+"$ref": "TransitTimeRow"
+},
+"type": "array"
+},
+"transitTimeLabels": {
+"description": "Required. A list of transit time labels. The last value can be `\"all other labels\"`. Example: `[\"food\", \"electronics\", \"all other labels\"]`.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"TransitTimeRow": {
+"description": "If there's only one dimension set of `postal_code_group_names` or `transit_time_labels`, there are multiple rows each with one value for that dimension. If there are two dimensions, each row corresponds to a `postal_code_group_names`, and columns (values) to a `transit_time_labels`.",
+"id": "TransitTimeRow",
+"properties": {
+"values": {
+"description": "Required. Transit time range (min-max) in business days.",
+"items": {
+"$ref": "TransitTimeValue"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"TransitTimeValue": {
+"description": "Transit time range (min-max) in business days.",
+"id": "TransitTimeValue",
+"properties": {
+"maxTransitDays": {
+"description": "Must be greater than or equal to `min_transit_days`.",
+"format": "int32",
+"type": "integer"
+},
+"minTransitDays": {
+"description": "Minimum transit time range in business days. 0 means same day delivery, 1 means next day delivery.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
+"UnclaimHomepageRequest": {
+"description": "Request message for the `UnclaimHomepage` method.",
+"id": "UnclaimHomepageRequest",
+"properties": {},
+"type": "object"
+},
+"UnregisterGcpRequest": {
+"description": "Request message for the UnregisterGCP method.",
+"id": "UnregisterGcpRequest",
+"properties": {},
+"type": "object"
+},
+"UriSettings": {
+"description": "URL settings for cart or checkout URL.",
+"id": "UriSettings",
+"properties": {
+"cartUriTemplate": {
+"description": "Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)",
+"type": "string"
+},
+"checkoutUriTemplate": {
+"description": "Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting)",
+"type": "string"
+}
+},
+"type": "object"
+},
+"User": {
+"description": "The `User` message represents a user associated with a Merchant Center account. It is used to manage user permissions and access rights within the account. For more information, see [Frequently asked questions about people and access levels](//support.google.com/merchants/answer/12160472).",
+"id": "User",
+"properties": {
+"accessRights": {
+"description": "Required. The [access rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes) the user has.",
+"items": {
+"enum": [
+"ACCESS_RIGHT_UNSPECIFIED",
+"STANDARD",
+"READ_ONLY",
+"ADMIN",
+"PERFORMANCE_REPORTING",
+"API_DEVELOPER"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Standard access rights.",
+"Has access to the same read-only methods as STANDARD, but no access to any mutating methods.",
+"Admin access rights.",
+"Users with this right have access to performance and insights.",
+"Users with this right have access to Merchant API and its notifications. This role is only accessible to accounts that has a developer registration."
+],
+"type": "string"
+},
+"type": "array"
+},
+"name": {
+"description": "Identifier. The resource name of the user. Format: `accounts/{account}/user/{email}` Use `me` to refer to your own email address, for example `accounts/{account}/users/me`.",
+"type": "string"
+},
+"state": {
+"description": "Output only. The state of the user.",
+"enum": [
+"STATE_UNSPECIFIED",
+"PENDING",
+"VERIFIED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The user is pending confirmation. In this state, the user first needs to accept the invitation before performing other actions.",
+"The user is verified."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"Value": {
+"description": "The single value of a rate group or the value of a rate group table's cell. Exactly one of `no_shipping`, `flat_rate`, `price_percentage`, `carrier_rateName`, `subtable_name` must be set.",
+"id": "Value",
+"properties": {
+"carrierRate": {
+"description": "The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set.",
+"type": "string"
+},
+"flatRate": {
+"$ref": "Price",
+"description": "A flat rate. Can only be set if all other fields are not set."
+},
+"noShipping": {
+"description": "If true, then the product can't be shipped. Must be true when set, can only be set if all other fields are not set.",
+"type": "boolean"
+},
+"pricePercentage": {
+"description": "A percentage of the price represented as a number in decimal notation (For example, `\"5.4\"`). Can only be set if all other fields are not set.",
+"type": "string"
+},
+"subtable": {
+"description": "The name of a subtable. Can only be set in table cells (For example, not for single values), and only if all other fields are not set.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"Warehouse": {
+"description": "A fulfillment warehouse, which stores and handles inventory.",
+"id": "Warehouse",
+"properties": {
+"businessDayConfig": {
+"$ref": "BusinessDayConfig",
+"description": "Business days of the warehouse. If not set, will be Monday to Friday by default."
+},
+"cutoffTime": {
+"$ref": "WarehouseCutoffTime",
+"description": "Required. The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code."
+},
+"handlingDays": {
+"description": "Required. The number of days it takes for this warehouse to pack up and ship an item. This is on the warehouse level, but can be overridden on the offer level based on the attributes of an item.",
+"format": "int64",
+"type": "string"
+},
+"name": {
+"description": "Required. The name of the warehouse. Must be unique within account.",
+"type": "string"
+},
+"shippingAddress": {
+"$ref": "Address",
+"description": "Required. Shipping address of the warehouse."
+}
+},
+"type": "object"
+},
+"WarehouseBasedDeliveryTime": {
+"description": "Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the settings of the selected carrier. When set, no other transit time related field in `delivery_time` should be set.",
+"id": "WarehouseBasedDeliveryTime",
+"properties": {
+"carrier": {
+"description": "Required. Carrier, such as `\"UPS\"` or `\"Fedex\"`. [supported carriers](https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-and-us-only)",
+"type": "string"
+},
+"carrierService": {
+"description": "Required. Carrier service, such as `\"ground\"` or `\"2 days\"`. The name of the service must be in the eddSupportedServices list.",
+"type": "string"
+},
+"warehouse": {
+"description": "Required. Warehouse name. This should match warehouse.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"WarehouseCutoffTime": {
+"description": "The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code.",
+"id": "WarehouseCutoffTime",
+"properties": {
+"hour": {
+"description": "Required. Hour of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Hour is based on the timezone of warehouse.",
+"format": "int32",
+"type": "integer"
+},
+"minute": {
+"description": "Required. Minute of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Minute is based on the timezone of warehouse.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
+"Weight": {
+"description": "The weight represented as the value in string and the unit.",
+"id": "Weight",
+"properties": {
+"amountMicros": {
+"description": "Required. The weight represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 kg = 1000000 micros). This field can also be set as infinity by setting to -1. This field only support -1 and positive value.",
+"format": "int64",
+"type": "string"
+},
+"unit": {
+"description": "Required. The weight unit. Acceptable values are: kg and lb",
+"enum": [
+"WEIGHT_UNIT_UNSPECIFIED",
+"POUND",
+"KILOGRAM"
+],
+"enumDescriptions": [
+"unit unspecified",
+"lb unit.",
+"kg unit."
+],
+"type": "string"
+}
+},
+"type": "object"
+}
+},
+"servicePath": "",
+"title": "Merchant API",
+"version": "accounts_v1",
+"version_module": true
+}
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json
index 3fd1d8a7f56..62c37b62f15 100644
--- a/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json
+++ b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json
@@ -2311,11 +2311,11 @@
 }
 }
 },
-"revision": "20250729",
+"revision": "20250803",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "About": {
-"description": "Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC)).",
+"description": "Collection of information related to the about page ([impressum](https://support.google.com/merchants/answer/14675634?ref_topic=15145634&sjid=6892280366904591178-NC)).",
 "id": "About",
 "properties": {
 "state": {
@@ -3635,7 +3635,7 @@ false
 "type": "object"
 },
 "InventoryVerification": {
-"description": "Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?hl=en&ref_topic=15145634&sjid=6892280366904591178-NC).",
+"description": "Collection of information related to [inventory verification](https://support.google.com/merchants/answer/14684499?ref_topic=15145634&sjid=6892280366904591178-NC).",
 "id": "InventoryVerification",
 "properties": {
 "contact": {
@@ -4145,7 +4145,7 @@ false
 "type": "object"
 },
 "OnDisplayToOrder": {
-"description": "Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?hl=en&ref_topic=15145747&sjid=6892280366904591178-NC)).",
+"description": "Collection of information related to the on display to order ([ODO](https://support.google.com/merchants/answer/14615056?ref_topic=15145747&sjid=6892280366904591178-NC)).",
 "id": "OnDisplayToOrder",
 "properties": {
 "state": {
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.conversions_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.conversions_v1.json
new file mode 100644
index 00000000000..fde7f2910f1
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/merchantapi.conversions_v1.json
@@ -0,0 +1,650 @@
+{
+"auth": {
+"oauth2": {
+"scopes": {
+"https://www.googleapis.com/auth/content": {
+"description": "Manage your product listings and accounts for Google Shopping"
+}
+}
+}
+},
+"basePath": "",
+"baseUrl": "https://merchantapi.googleapis.com/",
+"batchPath": "batch",
+"canonicalName": "Merchant",
+"description": "Programmatically manage your Merchant Center Accounts.",
+"discoveryVersion": "v1",
+"documentationLink": "https://developers.google.com/merchant/api",
+"fullyEncodeReservedExpansion": true,
+"icons": {
+"x16": "http://www.google.com/images/icons/product/search-16.gif",
+"x32": "http://www.google.com/images/icons/product/search-32.gif"
+},
+"id": "merchantapi:conversions_v1",
+"kind": "discovery#restDescription",
+"mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/",
+"name": "merchantapi",
+"ownerDomain": "google.com",
+"ownerName": "Google",
+"parameters": {
+"$.xgafv": {
+"description": "V1 error format.",
+"enum": [
+"1",
+"2"
+],
+"enumDescriptions": [
+"v1 error format",
+"v2 error format"
+],
+"location": "query",
+"type": "string"
+},
+"access_token": {
+"description": "OAuth access token.",
+"location": "query",
+"type": "string"
+},
+"alt": {
+"default": "json",
+"description": "Data format for response.",
+"enum": [
+"json",
+"media",
+"proto"
+],
+"enumDescriptions": [
+"Responses with Content-Type of application/json",
+"Media download with context-dependent Content-Type",
+"Responses with Content-Type of application/x-protobuf"
+],
+"location": "query",
+"type": "string"
+},
+"callback": {
+"description": "JSONP",
+"location": "query",
+"type": "string"
+},
+"fields": {
+"description": "Selector specifying which fields to include in a partial response.",
+"location": "query",
+"type": "string"
+},
+"key": {
+"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+"location": "query",
+"type": "string"
+},
+"oauth_token": {
+"description": "OAuth 2.0 token for the current user.",
+"location": "query",
+"type": "string"
+},
+"prettyPrint": {
+"default": "true",
+"description": "Returns response with indentations and line breaks.",
+"location": "query",
+"type": "boolean"
+},
+"quotaUser": {
+"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+"location": "query",
+"type": "string"
+},
+"uploadType": {
+"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+"location": "query",
+"type": "string"
+},
+"upload_protocol": {
+"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+"location": "query",
+"type": "string"
+}
+},
+"protocol": "rest",
+"resources": {
+"accounts": {
+"resources": {
+"conversionSources": {
+"methods": {
+"create": {
+"description": "Creates a new conversion source.",
+"flatPath": "conversions/v1/accounts/{accountsId}/conversionSources",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.conversionSources.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The merchant account that will own the new conversion source. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "conversions/v1/{+parent}/conversionSources",
+"request": {
+"$ref": "ConversionSource"
+},
+"response": {
+"$ref": "ConversionSource"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"delete": {
+"description": "Archives an existing conversion source. If the conversion source is a Merchant Center Destination, it will be recoverable for 30 days. If the conversion source is a Google Analytics Link, it will be deleted immediately and can be restored by creating a new one.",
+"flatPath": "conversions/v1/accounts/{accountsId}/conversionSources/{conversionSourcesId}",
+"httpMethod": "DELETE",
+"id": "merchantapi.accounts.conversionSources.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the conversion source to be deleted. Format: `accounts/{account}/conversionSources/{conversion_source}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/conversionSources/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "conversions/v1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Fetches a conversion source.",
+"flatPath": "conversions/v1/accounts/{accountsId}/conversionSources/{conversionSourcesId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.conversionSources.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the conversion source to be fetched. Format: `accounts/{account}/conversionSources/{conversion_source}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/conversionSources/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "conversions/v1/{+name}",
+"response": {
+"$ref": "ConversionSource"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "Retrieves the list of conversion sources the caller has access to.",
+"flatPath": "conversions/v1/accounts/{accountsId}/conversionSources",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.conversionSources.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of conversion sources to return in a page. If no `page_size` is specified, `100` is used as the default value. The maximum value is `200`. Values above `200` will be coerced to `200`. Regardless of pagination, at most `200` conversion sources are returned in total.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. Page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The merchant account who owns the collection of conversion sources. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+},
+"showDeleted": {
+"description": "Optional. Show deleted (archived) conversion sources. By default, deleted conversion sources are not returned.",
+"location": "query",
+"type": "boolean"
+}
+},
+"path": "conversions/v1/{+parent}/conversionSources",
+"response": {
+"$ref": "ListConversionSourcesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"patch": {
+"description": "Updates information of an existing conversion source. Available only for Merchant Center Destination conversion sources.",
+"flatPath": "conversions/v1/accounts/{accountsId}/conversionSources/{conversionSourcesId}",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.conversionSources.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Output only. Identifier. Generated by the Content API upon creation of a new `ConversionSource`. Format: `[a-z]{4}:.+` The four characters before the colon represent the type of conversion source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: * `galk`: For GoogleAnalyticsLink sources. * `mcdn`: For MerchantCenterDestination sources.",
+"location": "path",
+"pattern": "^accounts/[^/]+/conversionSources/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. List of fields being updated.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "conversions/v1/{+name}",
+"request": {
+"$ref": "ConversionSource"
+},
+"response": {
+"$ref": "ConversionSource"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"undelete": {
+"description": "Re-enables an archived conversion source. Only Available for Merchant Center Destination conversion sources.",
+"flatPath": "conversions/v1/accounts/{accountsId}/conversionSources/{conversionSourcesId}:undelete",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.conversionSources.undelete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the conversion source to be undeleted. Format: `accounts/{account}/conversionSources/{conversion_source}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/conversionSources/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "conversions/v1/{+name}:undelete",
+"request": {
+"$ref": "UndeleteConversionSourceRequest"
+},
+"response": {
+"$ref": "ConversionSource"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+}
+},
+"revision": "20250804",
+"rootUrl": "https://merchantapi.googleapis.com/",
+"schemas": {
+"AttributionSettings": {
+"description": "Represents attribution settings for conversion sources receiving pre-attribution data.",
+"id": "AttributionSettings",
+"properties": {
+"attributionLookbackWindowDays": {
+"description": "Required. Lookback window (in days) used for attribution in this source. Supported values are `7`, `30` & `40`.",
+"format": "int32",
+"type": "integer"
+},
+"attributionModel": {
+"description": "Required. Attribution model.",
+"enum": [
+"ATTRIBUTION_MODEL_UNSPECIFIED",
+"CROSS_CHANNEL_LAST_CLICK",
+"ADS_PREFERRED_LAST_CLICK",
+"CROSS_CHANNEL_DATA_DRIVEN",
+"CROSS_CHANNEL_FIRST_CLICK",
+"CROSS_CHANNEL_LINEAR",
+"CROSS_CHANNEL_POSITION_BASED",
+"CROSS_CHANNEL_TIME_DECAY"
+],
+"enumDescriptions": [
+"Unspecified model.",
+"Cross-channel Last Click model.",
+"Ads-preferred Last Click model.",
+"Cross-channel Data Driven model.",
+"Cross-channel First Click model.",
+"Cross-channel Linear model.",
+"Cross-channel Position Based model.",
+"Cross-channel Time Decay model."
+],
+"type": "string"
+},
+"conversionType": {
+"description": "Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard \"purchase\" type will be automatically created if this list is empty at creation time.",
+"items": {
+"$ref": "ConversionType"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"ConversionSource": {
+"description": "Represents a conversion source owned by a Merchant account. A merchant account can have up to 200 conversion sources.",
+"id": "ConversionSource",
+"properties": {
+"controller": {
+"description": "Output only. Controller of the conversion source.",
+"enum": [
+"CONTROLLER_UNSPECIFIED",
+"MERCHANT",
+"YOUTUBE_AFFILIATES"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Controlled by the Merchant who owns the Conversion Source.",
+"Controlled by the Youtube Affiliates program."
+],
+"readOnly": true,
+"type": "string"
+},
+"expireTime": {
+"description": "Output only. The time when an archived conversion source becomes permanently deleted and is no longer available to undelete.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"googleAnalyticsLink": {
+"$ref": "GoogleAnalyticsLink",
+"description": "Immutable. Conversion Source of type \"Link to Google Analytics Property\"."
+},
+"merchantCenterDestination": {
+"$ref": "MerchantCenterDestination",
+"description": "Conversion Source of type \"Merchant Center Tag Destination\"."
+},
+"name": {
+"description": "Output only. Identifier. Generated by the Content API upon creation of a new `ConversionSource`. Format: `[a-z]{4}:.+` The four characters before the colon represent the type of conversion source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: * `galk`: For GoogleAnalyticsLink sources. * `mcdn`: For MerchantCenterDestination sources.",
+"readOnly": true,
+"type": "string"
+},
+"state": {
+"description": "Output only. Current state of this conversion source. Can't be edited through the API.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ACTIVE",
+"ARCHIVED",
+"PENDING"
+],
+"enumDescriptions": [
+"Conversion source has unspecified state.",
+"Conversion source is fully functional.",
+"Conversion source has been archived in the last 30 days and is currently not functional. Can be restored using the undelete method.",
+"Conversion source creation has started but not fully finished yet."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"ConversionType": {
+"description": "Message representing the type of a conversion event.",
+"id": "ConversionType",
+"properties": {
+"name": {
+"description": "Output only. Conversion event name, as it'll be reported by the client.",
+"readOnly": true,
+"type": "string"
+},
+"report": {
+"description": "Output only. Option indicating if the type should be included in Merchant Center reporting.",
+"readOnly": true,
+"type": "boolean"
+}
+},
+"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",
+"properties": {},
+"type": "object"
+},
+"GoogleAnalyticsLink": {
+"description": "\"Google Analytics Link\" sources can be used to get conversion data from an existing Google Analytics property into the linked Merchant Center account.",
+"id": "GoogleAnalyticsLink",
+"properties": {
+"attributionSettings": {
+"$ref": "AttributionSettings",
+"description": "Output only. Attribution settings for the linked Google Analytics property.",
+"readOnly": true
+},
+"property": {
+"description": "Output only. Name of the Google Analytics property the merchant is linked to.",
+"readOnly": true,
+"type": "string"
+},
+"propertyId": {
+"description": "Required. Immutable. ID of the Google Analytics property the merchant is linked to.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ListConversionSourcesResponse": {
+"description": "Response message for the ListConversionSources method.",
+"id": "ListConversionSourcesResponse",
+"properties": {
+"conversionSources": {
+"description": "List of conversion sources.",
+"items": {
+"$ref": "ConversionSource"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "Token to be used to fetch the next results page.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"MerchantCenterDestination": {
+"description": "\"Merchant Center Destination\" sources can be used to send conversion events from an online store using a Google tag directly to a Merchant Center account where the source is created.",
+"id": "MerchantCenterDestination",
+"properties": {
+"attributionSettings": {
+"$ref": "AttributionSettings",
+"description": "Required. Attribution settings used for the Merchant Center Destination."
+},
+"currencyCode": {
+"description": "Required. Three-letter currency code (ISO 4217). The currency code defines in which currency the conversions sent to this destination will be reported in Merchant Center.",
+"type": "string"
+},
+"destination": {
+"description": "Output only. Merchant Center Destination ID.",
+"readOnly": true,
+"type": "string"
+},
+"displayName": {
+"description": "Required. Merchant-specified display name for the destination. This is the name that identifies the conversion source within the Merchant Center UI. The maximum length is 64 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductChange": {
+"description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.",
+"id": "ProductChange",
+"properties": {
+"newValue": {
+"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"oldValue": {
+"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"regionCode": {
+"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
+"type": "string"
+},
+"reportingContext": {
+"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductStatusChangeMessage": {
+"description": "The message that the merchant will receive to notify about product status change event",
+"id": "ProductStatusChangeMessage",
+"properties": {
+"account": {
+"description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`",
+"type": "string"
+},
+"attribute": {
+"description": "The attribute in the resource that changed, in this case it will be always `Status`.",
+"enum": [
+"ATTRIBUTE_UNSPECIFIED",
+"STATUS"
+],
+"enumDescriptions": [
+"Unspecified attribute",
+"Status of the changed entity"
+],
+"type": "string"
+},
+"changes": {
+"description": "A message to describe the change that happened to the product",
+"items": {
+"$ref": "ProductChange"
+},
+"type": "array"
+},
+"eventTime": {
+"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationTime": {
+"description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.",
+"format": "google-datetime",
+"type": "string"
+},
+"managingAccount": {
+"description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`",
+"type": "string"
+},
+"resource": {
+"description": "The product name. Format: `accounts/{account}/products/{product}`",
+"type": "string"
+},
+"resourceId": {
+"description": "The product id.",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource that changed, in this case it will always be `Product`.",
+"enum": [
+"RESOURCE_UNSPECIFIED",
+"PRODUCT"
+],
+"enumDescriptions": [
+"Unspecified resource",
+"Resource type : product"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"UndeleteConversionSourceRequest": {
+"description": "Request message for the UndeleteConversionSource method.",
+"id": "UndeleteConversionSourceRequest",
+"properties": {},
+"type": "object"
+}
+},
+"servicePath": "",
+"title": "Merchant API",
+"version": "conversions_v1",
+"version_module": true
+}
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.datasources_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.datasources_v1.json
new file mode 100644
index 00000000000..990e3a8d94c
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/merchantapi.datasources_v1.json
@@ -0,0 +1,1037 @@
+{
+"auth": {
+"oauth2": {
+"scopes": {
+"https://www.googleapis.com/auth/content": {
+"description": "Manage your product listings and accounts for Google Shopping"
+}
+}
+}
+},
+"basePath": "",
+"baseUrl": "https://merchantapi.googleapis.com/",
+"batchPath": "batch",
+"canonicalName": "Merchant",
+"description": "Programmatically manage your Merchant Center Accounts.",
+"discoveryVersion": "v1",
+"documentationLink": "https://developers.google.com/merchant/api",
+"fullyEncodeReservedExpansion": true,
+"icons": {
+"x16": "http://www.google.com/images/icons/product/search-16.gif",
+"x32": "http://www.google.com/images/icons/product/search-32.gif"
+},
+"id": "merchantapi:datasources_v1",
+"kind": "discovery#restDescription",
+"mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/",
+"name": "merchantapi",
+"ownerDomain": "google.com",
+"ownerName": "Google",
+"parameters": {
+"$.xgafv": {
+"description": "V1 error format.",
+"enum": [
+"1",
+"2"
+],
+"enumDescriptions": [
+"v1 error format",
+"v2 error format"
+],
+"location": "query",
+"type": "string"
+},
+"access_token": {
+"description": "OAuth access token.",
+"location": "query",
+"type": "string"
+},
+"alt": {
+"default": "json",
+"description": "Data format for response.",
+"enum": [
+"json",
+"media",
+"proto"
+],
+"enumDescriptions": [
+"Responses with Content-Type of application/json",
+"Media download with context-dependent Content-Type",
+"Responses with Content-Type of application/x-protobuf"
+],
+"location": "query",
+"type": "string"
+},
+"callback": {
+"description": "JSONP",
+"location": "query",
+"type": "string"
+},
+"fields": {
+"description": "Selector specifying which fields to include in a partial response.",
+"location": "query",
+"type": "string"
+},
+"key": {
+"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+"location": "query",
+"type": "string"
+},
+"oauth_token": {
+"description": "OAuth 2.0 token for the current user.",
+"location": "query",
+"type": "string"
+},
+"prettyPrint": {
+"default": "true",
+"description": "Returns response with indentations and line breaks.",
+"location": "query",
+"type": "boolean"
+},
+"quotaUser": {
+"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+"location": "query",
+"type": "string"
+},
+"uploadType": {
+"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+"location": "query",
+"type": "string"
+},
+"upload_protocol": {
+"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+"location": "query",
+"type": "string"
+}
+},
+"protocol": "rest",
+"resources": {
+"accounts": {
+"resources": {
+"dataSources": {
+"methods": {
+"create": {
+"description": "Creates the new data source configuration for the given account. This method always creates a new data source.",
+"flatPath": "datasources/v1/accounts/{accountsId}/dataSources",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.dataSources.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The account where this data source will be created. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "datasources/v1/{+parent}/dataSources",
+"request": {
+"$ref": "DataSource"
+},
+"response": {
+"$ref": "DataSource"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"delete": {
+"description": "Deletes a data source from your Merchant Center account.",
+"flatPath": "datasources/v1/accounts/{accountsId}/dataSources/{dataSourcesId}",
+"httpMethod": "DELETE",
+"id": "merchantapi.accounts.dataSources.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the data source to delete. Format: `accounts/{account}/dataSources/{datasource}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/dataSources/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "datasources/v1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"fetch": {
+"description": "Performs the data fetch immediately (even outside fetch schedule) on a data source from your Merchant Center Account. If you need to call this method more than once per day, you should use the Products service to update your product data instead. This method only works on data sources with a file input set.",
+"flatPath": "datasources/v1/accounts/{accountsId}/dataSources/{dataSourcesId}:fetch",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.dataSources.fetch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the data source resource to fetch. Format: `accounts/{account}/dataSources/{datasource}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/dataSources/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "datasources/v1/{+name}:fetch",
+"request": {
+"$ref": "FetchDataSourceRequest"
+},
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Retrieves the data source configuration for the given account.",
+"flatPath": "datasources/v1/accounts/{accountsId}/dataSources/{dataSourcesId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.dataSources.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the data source to retrieve. Format: `accounts/{account}/dataSources/{datasource}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/dataSources/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "datasources/v1/{+name}",
+"response": {
+"$ref": "DataSource"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "Lists the configurations for data sources for the given account.",
+"flatPath": "datasources/v1/accounts/{accountsId}/dataSources",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.dataSources.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of data sources to return. The service may return fewer than this value. The maximum value is 1000; values above 1000 will be coerced to 1000. If unspecified, the maximum number of data sources will be returned.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListDataSources` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListDataSources` must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The account to list data sources for. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "datasources/v1/{+parent}/dataSources",
+"response": {
+"$ref": "ListDataSourcesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"patch": {
+"description": "Updates the existing data source configuration. The fields that are set in the update mask but not provided in the resource will be deleted.",
+"flatPath": "datasources/v1/accounts/{accountsId}/dataSources/{dataSourcesId}",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.dataSources.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/dataSources/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Required. The list of data source fields to be updated. Fields specified in the update mask without a value specified in the body will be deleted from the data source. Providing special \"*\" value for full data source replacement is not supported. For example, If you insert `updateMask=displayName` in the request, it will only update the `displayName` leaving all other fields untouched.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "datasources/v1/{+name}",
+"request": {
+"$ref": "DataSource"
+},
+"response": {
+"$ref": "DataSource"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+},
+"resources": {
+"fileUploads": {
+"methods": {
+"get": {
+"description": "Gets the latest data source file upload. Only the `latest` alias is accepted for a file upload.",
+"flatPath": "datasources/v1/accounts/{accountsId}/dataSources/{dataSourcesId}/fileUploads/{fileUploadsId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.dataSources.fileUploads.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the data source file upload to retrieve. Format: `accounts/{account}/dataSources/{datasource}/fileUploads/latest`",
+"location": "path",
+"pattern": "^accounts/[^/]+/dataSources/[^/]+/fileUploads/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "datasources/v1/{+name}",
+"response": {
+"$ref": "FileUpload"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+}
+}
+}
+},
+"revision": "20250804",
+"rootUrl": "https://merchantapi.googleapis.com/",
+"schemas": {
+"DataSource": {
+"description": "The [data source](/merchant/api/guides/data-sources/overview) for the Merchant Center account.",
+"id": "DataSource",
+"properties": {
+"dataSourceId": {
+"description": "Output only. The data source id.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"displayName": {
+"description": "Required. The displayed data source name in the Merchant Center UI.",
+"type": "string"
+},
+"fileInput": {
+"$ref": "FileInput",
+"description": "Optional. The field is used only when data is managed through a file."
+},
+"input": {
+"description": "Output only. Determines the type of input to the data source. Based on the input some settings might not work. Only generic data sources can be created through the API.",
+"enum": [
+"INPUT_UNSPECIFIED",
+"API",
+"FILE",
+"UI",
+"AUTOFEED"
+],
+"enumDescriptions": [
+"Input unspecified.",
+"Represents data sources for which the data is primarily provided through the API.",
+"Represents data sources for which the data is primarily provided through file input. Data can still be provided through the API.",
+"The data source for products added directly in Merchant Center. This type of data source can not be created or updated through this API, only by Merchant Center UI. This type of data source is read only.",
+"This is also known as [Automated feeds](https://support.google.com/merchants/answer/12158480) used to automatically build your product data. This type of data source can be enabled or disabled through the Accounts sub-API."
+],
+"readOnly": true,
+"type": "string"
+},
+"localInventoryDataSource": {
+"$ref": "LocalInventoryDataSource",
+"description": "The [local inventory](https://support.google.com/merchants/answer/7023001) data source."
+},
+"merchantReviewDataSource": {
+"$ref": "MerchantReviewDataSource",
+"description": "The [merchant review](https://support.google.com/merchants/answer/7045996) data source."
+},
+"name": {
+"description": "Required. Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`",
+"type": "string"
+},
+"primaryProductDataSource": {
+"$ref": "PrimaryProductDataSource",
+"description": "The [primary data source](https://support.google.com/merchants/answer/7439058) for local and online products."
+},
+"productReviewDataSource": {
+"$ref": "ProductReviewDataSource",
+"description": "The [product review](https://support.google.com/merchants/answer/7045996) data source."
+},
+"promotionDataSource": {
+"$ref": "PromotionDataSource",
+"description": "The [promotion](https://support.google.com/merchants/answer/2906014) data source."
+},
+"regionalInventoryDataSource": {
+"$ref": "RegionalInventoryDataSource",
+"description": "The [regional inventory](https://support.google.com/merchants/answer/7439058) data source."
+},
+"supplementalProductDataSource": {
+"$ref": "SupplementalProductDataSource",
+"description": "The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products."
+}
+},
+"type": "object"
+},
+"DataSourceReference": {
+"description": "Data source reference can be used to manage related data sources within the data source service.",
+"id": "DataSourceReference",
+"properties": {
+"primaryDataSourceName": {
+"description": "Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`",
+"type": "string"
+},
+"self": {
+"description": "Self should be used to reference the primary data source itself.",
+"type": "boolean"
+},
+"supplementalDataSourceName": {
+"description": "Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`",
+"type": "string"
+}
+},
+"type": "object"
+},
+"DefaultRule": {
+"description": "Default rule management of the data source.",
+"id": "DefaultRule",
+"properties": {
+"takeFromDataSources": {
+"description": "Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`.",
+"items": {
+"$ref": "DataSourceReference"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"Destination": {
+"description": "Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections.",
+"id": "Destination",
+"properties": {
+"destination": {
+"description": "[Marketing methods](https://support.google.com/merchants/answer/15130232) (also known as destination) selections.",
+"enum": [
+"DESTINATION_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"YOUTUBE_SHOPPING",
+"YOUTUBE_SHOPPING_CHECKOUT",
+"YOUTUBE_AFFILIATE",
+"FREE_VEHICLE_LISTINGS",
+"VEHICLE_ADS",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL"
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/google-ads/answer/2454022).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3057972).",
+"[Free listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/12362804).",
+"Youtube shopping checkout.",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[Free vehicle listings](https://support.google.com/merchants/answer/11189169).",
+"[Vehicle ads](https://support.google.com/merchants/answer/11189169).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail)."
+],
+"type": "string"
+},
+"state": {
+"description": "The state of the destination.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ENABLED",
+"DISABLED"
+],
+"enumDescriptions": [
+"Not specified.",
+"Indicates that the destination is enabled.",
+"Indicates that the destination is disabled."
+],
+"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",
+"properties": {},
+"type": "object"
+},
+"FetchDataSourceRequest": {
+"description": "Request message for the FetchDataSource method.",
+"id": "FetchDataSourceRequest",
+"properties": {},
+"type": "object"
+},
+"FetchSettings": {
+"description": "Fetch details to deliver the data source.",
+"id": "FetchSettings",
+"properties": {
+"dayOfMonth": {
+"description": "Optional. The day of the month when the data source file should be fetched (1-31). This field can only be set for monthly frequency.",
+"format": "int32",
+"type": "integer"
+},
+"dayOfWeek": {
+"description": "Optional. The day of the week when the data source file should be fetched. This field can only be set for weekly frequency.",
+"enum": [
+"DAY_OF_WEEK_UNSPECIFIED",
+"MONDAY",
+"TUESDAY",
+"WEDNESDAY",
+"THURSDAY",
+"FRIDAY",
+"SATURDAY",
+"SUNDAY"
+],
+"enumDescriptions": [
+"The day of the week is unspecified.",
+"Monday",
+"Tuesday",
+"Wednesday",
+"Thursday",
+"Friday",
+"Saturday",
+"Sunday"
+],
+"type": "string"
+},
+"enabled": {
+"description": "Optional. Enables or pauses the fetch schedule.",
+"type": "boolean"
+},
+"fetchUri": {
+"description": "Optional. The URL where the data source file can be fetched. Google Merchant Center supports automatic scheduled uploads using the HTTP, HTTPS or SFTP protocols, so the value will need to be a valid link using one of those three protocols. Immutable for Google Sheets files.",
+"type": "string"
+},
+"frequency": {
+"description": "Required. The frequency describing fetch schedule.",
+"enum": [
+"FREQUENCY_UNSPECIFIED",
+"FREQUENCY_DAILY",
+"FREQUENCY_WEEKLY",
+"FREQUENCY_MONTHLY"
+],
+"enumDescriptions": [
+"Frequency unspecified.",
+"The fetch happens every day.",
+"The fetch happens every week.",
+"The fetch happens every month."
+],
+"type": "string"
+},
+"password": {
+"description": "Optional. An optional password for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).",
+"type": "string"
+},
+"timeOfDay": {
+"$ref": "TimeOfDay",
+"description": "Optional. The hour of the day when the data source file should be fetched. Minutes and seconds are not supported and will be ignored."
+},
+"timeZone": {
+"description": "Optional. [Time zone](https://cldr.unicode.org) used for schedule. UTC by default. For example, \"America/Los_Angeles\".",
+"type": "string"
+},
+"username": {
+"description": "Optional. An optional user name for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"FileInput": {
+"description": "The data specific for file data sources. This field is empty for other data source inputs.",
+"id": "FileInput",
+"properties": {
+"fetchSettings": {
+"$ref": "FetchSettings",
+"description": "Optional. Fetch details to deliver the data source. It contains settings for `FETCH` and `GOOGLE_SHEETS` file input types. The required fields vary based on the frequency of fetching."
+},
+"fileInputType": {
+"description": "Output only. The type of file input.",
+"enum": [
+"FILE_INPUT_TYPE_UNSPECIFIED",
+"UPLOAD",
+"FETCH",
+"GOOGLE_SHEETS"
+],
+"enumDescriptions": [
+"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. 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"
+},
+"fileName": {
+"description": "Optional. The file name of the data source. Required for `UPLOAD` file input type.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"FileUpload": {
+"description": "The file upload of a specific data source, that is, the result of the retrieval of the data source at a certain timestamp computed asynchronously when the data source processing is finished. Only applicable to file data sources.",
+"id": "FileUpload",
+"properties": {
+"dataSourceId": {
+"description": "Output only. The data source id.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"issues": {
+"description": "Output only. The list of issues occurring in the data source.",
+"items": {
+"$ref": "Issue"
+},
+"readOnly": true,
+"type": "array"
+},
+"itemsCreated": {
+"description": "Output only. The number of items in the data source that were created.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"itemsTotal": {
+"description": "Output only. The number of items in the data source that were processed.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"itemsUpdated": {
+"description": "Output only. The number of items in the data source that were updated.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Identifier. The name of the data source file upload. Format: `{datasource.name=accounts/{account}/dataSources/{datasource}/fileUploads/{fileupload}}`",
+"type": "string"
+},
+"processingState": {
+"description": "Output only. The processing state of the data source.",
+"enum": [
+"PROCESSING_STATE_UNSPECIFIED",
+"FAILED",
+"IN_PROGRESS",
+"SUCCEEDED"
+],
+"enumDescriptions": [
+"Processing state unspecified.",
+"The data source could not be processed or all the items had errors.",
+"The data source is being processed.",
+"The data source was processed successfully, though some items might have had errors."
+],
+"readOnly": true,
+"type": "string"
+},
+"uploadTime": {
+"description": "Output only. The date at which the file of the data source was uploaded.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"Issue": {
+"description": "An error occurring in the data source, like \"invalid price\".",
+"id": "Issue",
+"properties": {
+"code": {
+"description": "Output only. The code of the error, for example, \"validation/invalid_value\". Returns \"?\" if the code is unknown.",
+"readOnly": true,
+"type": "string"
+},
+"count": {
+"description": "Output only. The number of occurrences of the error in the file upload.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"description": {
+"description": "Output only. The error description, for example, \"Your data source contains items which have too many attributes, or are too big. These items will be dropped\".",
+"readOnly": true,
+"type": "string"
+},
+"documentationUri": {
+"description": "Output only. Link to the documentation explaining the issue in more details, if available.",
+"readOnly": true,
+"type": "string"
+},
+"severity": {
+"description": "Output only. The severity of the issue.",
+"enum": [
+"SEVERITY_UNSPECIFIED",
+"WARNING",
+"ERROR"
+],
+"enumDescriptions": [
+"Severity unspecified.",
+"The issue is the warning.",
+"The issue is an error."
+],
+"readOnly": true,
+"type": "string"
+},
+"title": {
+"description": "Output only. The title of the issue, for example, \"Item too big\".",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"ListDataSourcesResponse": {
+"description": "Response message for the ListDataSources method.",
+"id": "ListDataSourcesResponse",
+"properties": {
+"dataSources": {
+"description": "The data sources from the specified account.",
+"items": {
+"$ref": "DataSource"
+},
+"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"
+},
+"LocalInventoryDataSource": {
+"description": "The local inventory data source type is only available for file inputs and can't be used to create API local inventory data sources.",
+"id": "LocalInventoryDataSource",
+"properties": {
+"contentLanguage": {
+"description": "Required. Immutable. The two-letter ISO 639-1 language of the items to which the local inventory is provided.",
+"type": "string"
+},
+"feedLabel": {
+"description": "Required. Immutable. The feed label of the offers to which the local inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"MerchantReviewDataSource": {
+"description": "The merchant review data source.",
+"id": "MerchantReviewDataSource",
+"properties": {},
+"type": "object"
+},
+"PrimaryProductDataSource": {
+"description": "The primary data source for local and online products.",
+"id": "PrimaryProductDataSource",
+"properties": {
+"contentLanguage": {
+"description": "Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.",
+"type": "string"
+},
+"countries": {
+"description": "Optional. The countries where the items may be displayed. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"defaultRule": {
+"$ref": "DefaultRule",
+"description": "Optional. Default rule management of the data source. If set, the linked data sources will be replaced."
+},
+"destinations": {
+"description": "Optional. A list of destinations describing where products of the data source can be shown. When retrieving the data source, the list contains all the destinations that can be used for the data source, including the ones that are disabled for the data source but enabled for the account. Only destinations that are enabled on the account, for example through program participation, can be enabled on the data source. If unset, during creation, the destinations will be inherited based on the account level program participation. If set, during creation or update, the data source will be set only for the specified destinations. Updating this field requires at least one destination.",
+"items": {
+"$ref": "Destination"
+},
+"type": "array"
+},
+"feedLabel": {
+"description": "Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.",
+"type": "string"
+},
+"legacyLocal": {
+"description": "Optional. Immutable. Determines whether the products of this data source are **only** targeting local destinations. Legacy local products are prefixed with `local~` in the product resource ID. For example, `accounts/123/products/local~en~US~sku123`.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"ProductChange": {
+"description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.",
+"id": "ProductChange",
+"properties": {
+"newValue": {
+"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"oldValue": {
+"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"regionCode": {
+"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
+"type": "string"
+},
+"reportingContext": {
+"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductReviewDataSource": {
+"description": "The product review data source.",
+"id": "ProductReviewDataSource",
+"properties": {},
+"type": "object"
+},
+"ProductStatusChangeMessage": {
+"description": "The message that the merchant will receive to notify about product status change event",
+"id": "ProductStatusChangeMessage",
+"properties": {
+"account": {
+"description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`",
+"type": "string"
+},
+"attribute": {
+"description": "The attribute in the resource that changed, in this case it will be always `Status`.",
+"enum": [
+"ATTRIBUTE_UNSPECIFIED",
+"STATUS"
+],
+"enumDescriptions": [
+"Unspecified attribute",
+"Status of the changed entity"
+],
+"type": "string"
+},
+"changes": {
+"description": "A message to describe the change that happened to the product",
+"items": {
+"$ref": "ProductChange"
+},
+"type": "array"
+},
+"eventTime": {
+"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationTime": {
+"description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.",
+"format": "google-datetime",
+"type": "string"
+},
+"managingAccount": {
+"description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`",
+"type": "string"
+},
+"resource": {
+"description": "The product name. Format: `accounts/{account}/products/{product}`",
+"type": "string"
+},
+"resourceId": {
+"description": "The product id.",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource that changed, in this case it will always be `Product`.",
+"enum": [
+"RESOURCE_UNSPECIFIED",
+"PRODUCT"
+],
+"enumDescriptions": [
+"Unspecified resource",
+"Resource type : product"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"PromotionDataSource": {
+"description": "The promotion data source.",
+"id": "PromotionDataSource",
+"properties": {
+"contentLanguage": {
+"description": "Required. Immutable. The two-letter ISO 639-1 language of the items in the data source.",
+"type": "string"
+},
+"targetCountry": {
+"description": "Required. Immutable. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected [countries](https://support.google.com/merchants/answer/4588460).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"RegionalInventoryDataSource": {
+"id": "RegionalInventoryDataSource",
+"properties": {
+"contentLanguage": {
+"description": "Required. Immutable. The two-letter ISO 639-1 language of the items to which the regional inventory is provided.",
+"type": "string"
+},
+"feedLabel": {
+"description": "Required. Immutable. The feed label of the offers to which the regional inventory is provided. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"SupplementalProductDataSource": {
+"description": "The supplemental data source for local and online products. After creation, you should make sure to link the supplemental product data source into one or more primary product data sources.",
+"id": "SupplementalProductDataSource",
+"properties": {
+"contentLanguage": {
+"description": "Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.",
+"type": "string"
+},
+"feedLabel": {
+"description": "Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. The fields must be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.",
+"type": "string"
+},
+"referencingPrimaryDataSources": {
+"description": "Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed.",
+"items": {
+"$ref": "DataSourceReference"
+},
+"readOnly": true,
+"type": "array"
+}
+},
+"type": "object"
+},
+"TimeOfDay": {
+"description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.",
+"id": "TimeOfDay",
+"properties": {
+"hours": {
+"description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.",
+"format": "int32",
+"type": "integer"
+},
+"minutes": {
+"description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.",
+"format": "int32",
+"type": "integer"
+},
+"nanos": {
+"description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.",
+"format": "int32",
+"type": "integer"
+},
+"seconds": {
+"description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+}
+},
+"servicePath": "",
+"title": "Merchant API",
+"version": "datasources_v1",
+"version_module": true
+}
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.inventories_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.inventories_v1.json
new file mode 100644
index 00000000000..05edfe7e7f4
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/merchantapi.inventories_v1.json
@@ -0,0 +1,713 @@
+{
+"auth": {
+"oauth2": {
+"scopes": {
+"https://www.googleapis.com/auth/content": {
+"description": "Manage your product listings and accounts for Google Shopping"
+}
+}
+}
+},
+"basePath": "",
+"baseUrl": "https://merchantapi.googleapis.com/",
+"batchPath": "batch",
+"canonicalName": "Merchant",
+"description": "Programmatically manage your Merchant Center Accounts.",
+"discoveryVersion": "v1",
+"documentationLink": "https://developers.google.com/merchant/api",
+"fullyEncodeReservedExpansion": true,
+"icons": {
+"x16": "http://www.google.com/images/icons/product/search-16.gif",
+"x32": "http://www.google.com/images/icons/product/search-32.gif"
+},
+"id": "merchantapi:inventories_v1",
+"kind": "discovery#restDescription",
+"mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/",
+"name": "merchantapi",
+"ownerDomain": "google.com",
+"ownerName": "Google",
+"parameters": {
+"$.xgafv": {
+"description": "V1 error format.",
+"enum": [
+"1",
+"2"
+],
+"enumDescriptions": [
+"v1 error format",
+"v2 error format"
+],
+"location": "query",
+"type": "string"
+},
+"access_token": {
+"description": "OAuth access token.",
+"location": "query",
+"type": "string"
+},
+"alt": {
+"default": "json",
+"description": "Data format for response.",
+"enum": [
+"json",
+"media",
+"proto"
+],
+"enumDescriptions": [
+"Responses with Content-Type of application/json",
+"Media download with context-dependent Content-Type",
+"Responses with Content-Type of application/x-protobuf"
+],
+"location": "query",
+"type": "string"
+},
+"callback": {
+"description": "JSONP",
+"location": "query",
+"type": "string"
+},
+"fields": {
+"description": "Selector specifying which fields to include in a partial response.",
+"location": "query",
+"type": "string"
+},
+"key": {
+"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+"location": "query",
+"type": "string"
+},
+"oauth_token": {
+"description": "OAuth 2.0 token for the current user.",
+"location": "query",
+"type": "string"
+},
+"prettyPrint": {
+"default": "true",
+"description": "Returns response with indentations and line breaks.",
+"location": "query",
+"type": "boolean"
+},
+"quotaUser": {
+"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+"location": "query",
+"type": "string"
+},
+"uploadType": {
+"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+"location": "query",
+"type": "string"
+},
+"upload_protocol": {
+"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+"location": "query",
+"type": "string"
+}
+},
+"protocol": "rest",
+"resources": {
+"accounts": {
+"resources": {
+"products": {
+"resources": {
+"localInventories": {
+"methods": {
+"delete": {
+"description": "Deletes the specified `LocalInventory` from the given product in your merchant account. It might take a up to an hour for the `LocalInventory` to be deleted from the specific product. Once you have received a successful delete response, wait for that period before attempting a delete again.",
+"flatPath": "inventories/v1/accounts/{accountsId}/products/{productsId}/localInventories/{localInventoriesId}",
+"httpMethod": "DELETE",
+"id": "merchantapi.accounts.products.localInventories.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the local inventory for the given product to delete. Format: `accounts/{account}/products/{product}/localInventories/{store_code}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/products/[^/]+/localInventories/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "inventories/v1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"insert": {
+"description": "Inserts a `LocalInventory` resource to a product in your merchant account. Replaces the full `LocalInventory` resource if an entry with the same `storeCode` already exists for the product. It might take up to 30 minutes for the new or updated `LocalInventory` resource to appear in products.",
+"flatPath": "inventories/v1/accounts/{accountsId}/products/{productsId}/localInventories:insert",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.products.localInventories.insert",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The account and product where this inventory will be inserted. Format: `accounts/{account}/products/{product}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/products/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "inventories/v1/{+parent}/localInventories:insert",
+"request": {
+"$ref": "LocalInventory"
+},
+"response": {
+"$ref": "LocalInventory"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "Lists the `LocalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `LocalInventory` resources are listed per product for a given account.",
+"flatPath": "inventories/v1/accounts/{accountsId}/products/{productsId}/localInventories",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.products.localInventories.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "The maximum number of `LocalInventory` resources for the given product to return. The service returns fewer than this value if the number of inventories for the given product is less that than the `pageSize`. The default value is 25000. The maximum value is 25000; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "A page token, received from a previous `ListLocalInventories` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `ListLocalInventories` must match the call that provided the page token. The token returned as nextPageToken in the response to the previous request.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The `name` of the parent product to list local inventories for. Format: `accounts/{account}/products/{product}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/products/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "inventories/v1/{+parent}/localInventories",
+"response": {
+"$ref": "ListLocalInventoriesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"regionalInventories": {
+"methods": {
+"delete": {
+"description": "Deletes the specified `RegionalInventory` resource from the given product in your merchant account. It might take up to an hour for the `RegionalInventory` to be deleted from the specific product. Once you have received a successful delete response, wait for that period before attempting a delete again.",
+"flatPath": "inventories/v1/accounts/{accountsId}/products/{productsId}/regionalInventories/{regionalInventoriesId}",
+"httpMethod": "DELETE",
+"id": "merchantapi.accounts.products.regionalInventories.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the `RegionalInventory` resource to delete. Format: `accounts/{account}/products/{product}/regionalInventories/{region}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/products/[^/]+/regionalInventories/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "inventories/v1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"insert": {
+"description": "Inserts a `RegionalInventory` to a given product in your merchant account. Replaces the full `RegionalInventory` resource if an entry with the same `region` already exists for the product. It might take up to 30 minutes for the new or updated `RegionalInventory` resource to appear in products.",
+"flatPath": "inventories/v1/accounts/{accountsId}/products/{productsId}/regionalInventories:insert",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.products.regionalInventories.insert",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The account and product where this inventory will be inserted. Format: `accounts/{account}/products/{product}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/products/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "inventories/v1/{+parent}/regionalInventories:insert",
+"request": {
+"$ref": "RegionalInventory"
+},
+"response": {
+"$ref": "RegionalInventory"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "Lists the `RegionalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `RegionalInventory` resources are listed per product for a given account.",
+"flatPath": "inventories/v1/accounts/{accountsId}/products/{productsId}/regionalInventories",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.products.regionalInventories.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "The maximum number of `RegionalInventory` resources for the given product to return. The service returns fewer than this value if the number of inventories for the given product is less that than the `pageSize`. The default value is 25000. The maximum value is 100000; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "A page token, received from a previous `ListRegionalInventories` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `ListRegionalInventories` must match the call that provided the page token. The token returned as nextPageToken in the response to the previous request.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The `name` of the parent product to list `RegionalInventory` resources for. Format: `accounts/{account}/products/{product}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/products/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "inventories/v1/{+parent}/regionalInventories",
+"response": {
+"$ref": "ListRegionalInventoriesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+}
+}
+}
+},
+"revision": "20250804",
+"rootUrl": "https://merchantapi.googleapis.com/",
+"schemas": {
+"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",
+"properties": {},
+"type": "object"
+},
+"Interval": {
+"description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.",
+"id": "Interval",
+"properties": {
+"endTime": {
+"description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.",
+"format": "google-datetime",
+"type": "string"
+},
+"startTime": {
+"description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ListLocalInventoriesResponse": {
+"description": "Response message for the `ListLocalInventories` method.",
+"id": "ListLocalInventoriesResponse",
+"properties": {
+"localInventories": {
+"description": "The `LocalInventory` resources for the given product from the specified account.",
+"items": {
+"$ref": "LocalInventory"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ListRegionalInventoriesResponse": {
+"description": "Response message for the `ListRegionalInventories` method.",
+"id": "ListRegionalInventoriesResponse",
+"properties": {
+"nextPageToken": {
+"description": "A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
+"type": "string"
+},
+"regionalInventories": {
+"description": "The `RegionalInventory` resources for the given product from the specified account.",
+"items": {
+"$ref": "RegionalInventory"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"LocalInventory": {
+"description": "Local inventory information for the product. Represents in-store information for a specific product at the store specified by `storeCode`. For a list of all accepted attribute values, see the [local product inventory data specification](https://support.google.com/merchants/answer/3061342).",
+"id": "LocalInventory",
+"properties": {
+"account": {
+"description": "Output only. The account that owns the product. This field will be ignored if set by the client.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"localInventoryAttributes": {
+"$ref": "LocalInventoryAttributes",
+"description": "Optional. A list of local inventory attributes."
+},
+"name": {
+"description": "Output only. The name of the `LocalInventory` resource. Format: `accounts/{account}/products/{product}/localInventories/{store_code}`",
+"readOnly": true,
+"type": "string"
+},
+"storeCode": {
+"description": "Required. Immutable. Store code (the store ID from your Business Profile) of the physical store the product is sold in. See the [Local product inventory data specification](https://support.google.com/merchants/answer/3061342) for more information.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"LocalInventoryAttributes": {
+"description": "Local inventory attributes.",
+"id": "LocalInventoryAttributes",
+"properties": {
+"availability": {
+"description": "[Availability](https://support.google.com/merchants/answer/3061342) of the product at this store.",
+"enum": [
+"LOCAL_INVENTORY_AVAILABILITY_UNSPECIFIED",
+"IN_STOCK",
+"LIMITED_AVAILABILITY",
+"ON_DISPLAY_TO_ORDER",
+"OUT_OF_STOCK"
+],
+"enumDescriptions": [
+"Indicates that the availability is unspecified.",
+"Indicates that the product is in stock.",
+"Indicates that the product is out of stock.",
+"Indicates that the product is on display to order.",
+"Indicates that the product is out of stock."
+],
+"type": "string"
+},
+"instoreProductLocation": {
+"description": "Optional. Location of the product inside the store. Maximum length is 20 bytes.",
+"type": "string"
+},
+"pickupMethod": {
+"description": "Optional. Supported [pickup method](https://support.google.com/merchants/answer/3061342) for this product. Unless the value is `\"not supported\"`, this field must be submitted together with `pickupSla`.",
+"enum": [
+"PICKUP_METHOD_UNSPECIFIED",
+"BUY",
+"RESERVE",
+"SHIP_TO_STORE",
+"NOT_SUPPORTED"
+],
+"enumDescriptions": [
+"Indicates that the pickup method is unspecified.",
+"Indicates that the pickup method is Buy.",
+"Indicates that the pickup method is Reserve.",
+"Indicates that the pickup method is Ship to store.",
+"Indicates that the pickup method is not supported."
+],
+"type": "string"
+},
+"pickupSla": {
+"description": "Optional. Relative time period from the order date for an order for this product, from this store, to be ready for pickup. Must be submitted with `pickupMethod`. See more details [here](https://support.google.com/merchants/answer/3061342).",
+"enum": [
+"PICKUP_SLA_UNSPECIFIED",
+"SAME_DAY",
+"NEXT_DAY",
+"TWO_DAY",
+"THREE_DAY",
+"FOUR_DAY",
+"FIVE_DAY",
+"SIX_DAY",
+"SEVEN_DAY",
+"MULTI_WEEK"
+],
+"enumDescriptions": [
+"Indicates that the pickup SLA is unspecified.",
+"Indicates that the pickup SLA is same day.",
+"Indicates that the pickup SLA is next day.",
+"Indicates that the pickup SLA is two days.",
+"Indicates that the pickup SLA is three days.",
+"Indicates that the pickup SLA is four days.",
+"Indicates that the pickup SLA is five days.",
+"Indicates that the pickup SLA is six days.",
+"Indicates that the pickup SLA is seven days.",
+"Indicates that the pickup SLA is multi-week."
+],
+"type": "string"
+},
+"price": {
+"$ref": "Price",
+"description": "Optional. Price of the product at this store."
+},
+"quantity": {
+"description": "Optional. Quantity of the product available at this store. Must be greater than or equal to zero.",
+"format": "int64",
+"type": "string"
+},
+"salePrice": {
+"$ref": "Price",
+"description": "Optional. Sale price of the product at this store. Mandatory if `salePriceEffectiveDate` is defined."
+},
+"salePriceEffectiveDate": {
+"$ref": "Interval",
+"description": "Optional. The `TimePeriod` of the sale at this store."
+}
+},
+"type": "object"
+},
+"Price": {
+"description": "The price represented as a number and currency.",
+"id": "Price",
+"properties": {
+"amountMicros": {
+"description": "The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).",
+"format": "int64",
+"type": "string"
+},
+"currencyCode": {
+"description": "The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductChange": {
+"description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.",
+"id": "ProductChange",
+"properties": {
+"newValue": {
+"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"oldValue": {
+"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"regionCode": {
+"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
+"type": "string"
+},
+"reportingContext": {
+"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductStatusChangeMessage": {
+"description": "The message that the merchant will receive to notify about product status change event",
+"id": "ProductStatusChangeMessage",
+"properties": {
+"account": {
+"description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`",
+"type": "string"
+},
+"attribute": {
+"description": "The attribute in the resource that changed, in this case it will be always `Status`.",
+"enum": [
+"ATTRIBUTE_UNSPECIFIED",
+"STATUS"
+],
+"enumDescriptions": [
+"Unspecified attribute",
+"Status of the changed entity"
+],
+"type": "string"
+},
+"changes": {
+"description": "A message to describe the change that happened to the product",
+"items": {
+"$ref": "ProductChange"
+},
+"type": "array"
+},
+"eventTime": {
+"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationTime": {
+"description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.",
+"format": "google-datetime",
+"type": "string"
+},
+"managingAccount": {
+"description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`",
+"type": "string"
+},
+"resource": {
+"description": "The product name. Format: `accounts/{account}/products/{product}`",
+"type": "string"
+},
+"resourceId": {
+"description": "The product id.",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource that changed, in this case it will always be `Product`.",
+"enum": [
+"RESOURCE_UNSPECIFIED",
+"PRODUCT"
+],
+"enumDescriptions": [
+"Unspecified resource",
+"Resource type : product"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"RegionalInventory": {
+"description": "Regional inventory information for the product. Represents specific information like price and availability for a given product in a specific `region`. For a list of all accepted attribute values, see the [regional product inventory data specification](https://support.google.com/merchants/answer/9698880).",
+"id": "RegionalInventory",
+"properties": {
+"account": {
+"description": "Output only. The account that owns the product. This field will be ignored if set by the client.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Output only. The name of the `RegionalInventory` resource. Format: `{regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}`",
+"readOnly": true,
+"type": "string"
+},
+"region": {
+"description": "Required. Immutable. ID of the region for this `RegionalInventory` resource. See the [Regional availability and pricing](https://support.google.com/merchants/answer/9698880) for more details.",
+"type": "string"
+},
+"regionalInventoryAttributes": {
+"$ref": "RegionalInventoryAttributes",
+"description": "Optional. A list of regional inventory attributes."
+}
+},
+"type": "object"
+},
+"RegionalInventoryAttributes": {
+"description": "Regional inventory attributes.",
+"id": "RegionalInventoryAttributes",
+"properties": {
+"availability": {
+"description": "Optional. [Availability](https://support.google.com/merchants/answer/14644124) of the product in this region.",
+"enum": [
+"REGIONAL_INVENTORY_AVAILABILITY_UNSPECIFIED",
+"IN_STOCK",
+"OUT_OF_STOCK"
+],
+"enumDescriptions": [
+"Indicates that the availability is unspecified.",
+"Indicates that the product is in stock.",
+"Indicates that the product is out of stock."
+],
+"type": "string"
+},
+"price": {
+"$ref": "Price",
+"description": "Optional. Price of the product in this region."
+},
+"salePrice": {
+"$ref": "Price",
+"description": "Optional. Sale price of the product in this region. Mandatory if `salePriceEffectiveDate` is defined."
+},
+"salePriceEffectiveDate": {
+"$ref": "Interval",
+"description": "Optional. The `TimePeriod` of the sale price in this region."
+}
+},
+"type": "object"
+}
+},
+"servicePath": "",
+"title": "Merchant API",
+"version": "inventories_v1",
+"version_module": true
+}
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.issueresolution_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.issueresolution_v1.json
new file mode 100644
index 00000000000..ba39aa9cb91
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/merchantapi.issueresolution_v1.json
@@ -0,0 +1,1248 @@
+{
+"auth": {
+"oauth2": {
+"scopes": {
+"https://www.googleapis.com/auth/content": {
+"description": "Manage your product listings and accounts for Google Shopping"
+}
+}
+}
+},
+"basePath": "",
+"baseUrl": "https://merchantapi.googleapis.com/",
+"batchPath": "batch",
+"canonicalName": "Merchant",
+"description": "Programmatically manage your Merchant Center Accounts.",
+"discoveryVersion": "v1",
+"documentationLink": "https://developers.google.com/merchant/api",
+"fullyEncodeReservedExpansion": true,
+"icons": {
+"x16": "http://www.google.com/images/icons/product/search-16.gif",
+"x32": "http://www.google.com/images/icons/product/search-32.gif"
+},
+"id": "merchantapi:issueresolution_v1",
+"kind": "discovery#restDescription",
+"mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/",
+"name": "merchantapi",
+"ownerDomain": "google.com",
+"ownerName": "Google",
+"parameters": {
+"$.xgafv": {
+"description": "V1 error format.",
+"enum": [
+"1",
+"2"
+],
+"enumDescriptions": [
+"v1 error format",
+"v2 error format"
+],
+"location": "query",
+"type": "string"
+},
+"access_token": {
+"description": "OAuth access token.",
+"location": "query",
+"type": "string"
+},
+"alt": {
+"default": "json",
+"description": "Data format for response.",
+"enum": [
+"json",
+"media",
+"proto"
+],
+"enumDescriptions": [
+"Responses with Content-Type of application/json",
+"Media download with context-dependent Content-Type",
+"Responses with Content-Type of application/x-protobuf"
+],
+"location": "query",
+"type": "string"
+},
+"callback": {
+"description": "JSONP",
+"location": "query",
+"type": "string"
+},
+"fields": {
+"description": "Selector specifying which fields to include in a partial response.",
+"location": "query",
+"type": "string"
+},
+"key": {
+"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+"location": "query",
+"type": "string"
+},
+"oauth_token": {
+"description": "OAuth 2.0 token for the current user.",
+"location": "query",
+"type": "string"
+},
+"prettyPrint": {
+"default": "true",
+"description": "Returns response with indentations and line breaks.",
+"location": "query",
+"type": "boolean"
+},
+"quotaUser": {
+"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+"location": "query",
+"type": "string"
+},
+"uploadType": {
+"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+"location": "query",
+"type": "string"
+},
+"upload_protocol": {
+"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+"location": "query",
+"type": "string"
+}
+},
+"protocol": "rest",
+"resources": {
+"accounts": {
+"resources": {
+"aggregateProductStatuses": {
+"methods": {
+"list": {
+"description": "Lists the `AggregateProductStatuses` resources for your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results.",
+"flatPath": "issueresolution/v1/accounts/{accountsId}/aggregateProductStatuses",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.aggregateProductStatuses.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"filter": {
+"description": "Optional. A filter expression that filters the aggregate product statuses. Filtering is only supported by the `reporting_context` and `country` field. For example: `reporting_context = \"SHOPPING_ADS\" AND country = \"US\"`.",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Optional. The maximum number of aggregate product statuses to return. The service may return fewer than this value. If unspecified, at most 25 aggregate product statuses are returned. The maximum value is 250; values above 250 are coerced to 250.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListAggregateProductStatuses` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAggregateProductStatuses` must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The account to list aggregate product statuses for. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "issueresolution/v1/{+parent}/aggregateProductStatuses",
+"response": {
+"$ref": "ListAggregateProductStatusesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+},
+"issueresolution": {
+"methods": {
+"renderaccountissues": {
+"description": "Provide a list of business's account issues with an issue resolution content and available actions. This content and actions are meant to be rendered and shown in third-party applications.",
+"flatPath": "issueresolution/v1/accounts/{accountsId}:renderaccountissues",
+"httpMethod": "POST",
+"id": "merchantapi.issueresolution.renderaccountissues",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"languageCode": {
+"description": "Optional. The [IETF BCP-47](https://tools.ietf.org/html/bcp47) language code used to localize issue resolution content. If not set, the result will be in default language `en-US`.",
+"location": "query",
+"type": "string"
+},
+"name": {
+"description": "Required. The account to fetch issues for. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+},
+"timeZone": {
+"description": "Optional. The [IANA](https://www.iana.org/time-zones) timezone used to localize times in an issue resolution content. For example 'America/Los_Angeles'. If not set, results will use as a default UTC.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "issueresolution/v1/{+name}:renderaccountissues",
+"request": {
+"$ref": "RenderIssuesRequestPayload"
+},
+"response": {
+"$ref": "RenderAccountIssuesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"renderproductissues": {
+"description": "Provide a list of issues for business's product with an issue resolution content and available actions. This content and actions are meant to be rendered and shown in third-party applications.",
+"flatPath": "issueresolution/v1/accounts/{accountsId}/products/{productsId}:renderproductissues",
+"httpMethod": "POST",
+"id": "merchantapi.issueresolution.renderproductissues",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"languageCode": {
+"description": "Optional. The [IETF BCP-47](https://tools.ietf.org/html/bcp47) language code used to localize an issue resolution content. If not set, the result will be in default language `en-US`.",
+"location": "query",
+"type": "string"
+},
+"name": {
+"description": "Required. The name of the product to fetch issues for. Format: `accounts/{account}/products/{product}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/products/[^/]+$",
+"required": true,
+"type": "string"
+},
+"timeZone": {
+"description": "Optional. The [IANA](https://www.iana.org/time-zones) timezone used to localize times in an issue resolution content. For example 'America/Los_Angeles'. If not set, results will use as a default UTC.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "issueresolution/v1/{+name}:renderproductissues",
+"request": {
+"$ref": "RenderIssuesRequestPayload"
+},
+"response": {
+"$ref": "RenderProductIssuesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"triggeraction": {
+"description": "Start an action. The action can be requested by a business in third-party application. Before the business can request the action, the third-party application needs to show them action specific content and display a user input form. The action can be successfully started only once all `required` inputs are provided. If any `required` input is missing, or invalid value was provided, the service will return 400 error. Validation errors will contain Ids for all problematic field together with translated, human readable error messages that can be shown to the user.",
+"flatPath": "issueresolution/v1/accounts/{accountsId}:triggeraction",
+"httpMethod": "POST",
+"id": "merchantapi.issueresolution.triggeraction",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"languageCode": {
+"description": "Optional. Language code [IETF BCP 47 syntax](https://tools.ietf.org/html/bcp47) used to localize the response. If not set, the result will be in default language `en-US`.",
+"location": "query",
+"type": "string"
+},
+"name": {
+"description": "Required. The business's account that is triggering the action. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "issueresolution/v1/{+name}:triggeraction",
+"request": {
+"$ref": "TriggerActionPayload"
+},
+"response": {
+"$ref": "TriggerActionResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+},
+"revision": "20250804",
+"rootUrl": "https://merchantapi.googleapis.com/",
+"schemas": {
+"Action": {
+"description": "An actionable step that can be executed to solve the issue.",
+"id": "Action",
+"properties": {
+"builtinSimpleAction": {
+"$ref": "BuiltInSimpleAction",
+"description": "Action implemented and performed in (your) third-party application. The application should point the business to the place, where they can access the corresponding functionality or provide instructions, if the specific functionality is not available."
+},
+"builtinUserInputAction": {
+"$ref": "BuiltInUserInputAction",
+"description": "Action implemented and performed in (your) third-party application. The application needs to show an additional content and input form to the business as specified for given action. They can trigger the action only when they provided all required inputs."
+},
+"buttonLabel": {
+"description": "Label of the action button.",
+"type": "string"
+},
+"externalAction": {
+"$ref": "ExternalAction",
+"description": "Action that is implemented and performed outside of (your) third-party application. The application needs to redirect the business to the external location where they can perform the action."
+},
+"isAvailable": {
+"description": "Controlling whether the button is active or disabled. The value is 'false' when the action was already requested or is not available. If the action is not available then a reason will be present. If (your) third-party application shows a disabled button for action that is not available, then it should also show reasons.",
+"type": "boolean"
+},
+"reasons": {
+"description": "List of reasons why the action is not available. The list of reasons is empty if the action is available. If there is only one reason, it can be displayed next to the disabled button. If there are more reasons, all of them should be displayed, for example in a pop-up dialog.",
+"items": {
+"$ref": "Reason"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"ActionFlow": {
+"description": "Flow that can be selected for an action. When a business selects a flow, application should open a dialog with more information and input form.",
+"id": "ActionFlow",
+"properties": {
+"dialogButtonLabel": {
+"description": "Label for the button to trigger the action from the action dialog. For example: \"Request review\"",
+"type": "string"
+},
+"dialogCallout": {
+"$ref": "Callout",
+"description": "Important message to be highlighted in the request dialog. For example: \"You can only request a review for disagreeing with this issue once. If it's not approved, you'll need to fix the issue and wait a few days before you can request another review.\""
+},
+"dialogMessage": {
+"$ref": "TextWithTooltip",
+"description": "Message displayed in the request dialog. For example: \"Make sure you've fixed all your country-specific issues. If not, you may have to wait 7 days to request another review\". There may be an more information to be shown in a tooltip."
+},
+"dialogTitle": {
+"description": "Title of the request dialog. For example: \"Before you request a review\"",
+"type": "string"
+},
+"id": {
+"description": "Not for display but need to be sent back for the selected action flow.",
+"type": "string"
+},
+"inputs": {
+"description": "A list of input fields.",
+"items": {
+"$ref": "InputField"
+},
+"type": "array"
+},
+"label": {
+"description": "Text value describing the intent for the action flow. It can be used as an input label if business needs to pick one of multiple flows. For example: \"I disagree with the issue\"",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ActionInput": {
+"description": "Input provided by the business.",
+"id": "ActionInput",
+"properties": {
+"actionFlowId": {
+"description": "Required. Id of the selected action flow.",
+"type": "string"
+},
+"inputValues": {
+"description": "Required. Values for input fields.",
+"items": {
+"$ref": "InputValue"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"AdditionalContent": {
+"description": "Long text from external source.",
+"id": "AdditionalContent",
+"properties": {
+"paragraphs": {
+"description": "Long text organized into paragraphs.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"title": {
+"description": "Title of the additional content;",
+"type": "string"
+}
+},
+"type": "object"
+},
+"AggregateProductStatus": {
+"description": "Aggregate product statuses for a given reporting context and country.",
+"id": "AggregateProductStatus",
+"properties": {
+"country": {
+"description": "The country of the aggregate product statuses. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).",
+"type": "string"
+},
+"itemLevelIssues": {
+"description": "The product issues that affect the given reporting context and country.",
+"items": {
+"$ref": "ItemLevelIssue"
+},
+"type": "array"
+},
+"name": {
+"description": "Identifier. The name of the `AggregateProductStatuses` resource. Format: `accounts/{account}/aggregateProductStatuses/{aggregateProductStatuses}`",
+"type": "string"
+},
+"reportingContext": {
+"description": "The reporting context of the aggregate product statuses.",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+},
+"stats": {
+"$ref": "Stats",
+"description": "Products statistics for the given reporting context and country."
+}
+},
+"type": "object"
+},
+"Breakdown": {
+"description": "A detailed impact breakdown for a group of regions where the impact of the issue on different shopping destinations is the same.",
+"id": "Breakdown",
+"properties": {
+"details": {
+"description": "Human readable, localized description of issue's effect on different targets. Should be rendered as a list. For example: * \"Products not showing in ads\" * \"Products not showing organically\"",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"regions": {
+"description": "Lists of regions. Should be rendered as a title for this group of details. The full list should be shown to the business. If the list is too long, it is recommended to make it expandable.",
+"items": {
+"$ref": "Region"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"BuiltInSimpleAction": {
+"description": "Action that is implemented and performed in (your) third-party application. Represents various functionality that is expected to be available to business and will help them with resolving the issue. The application should point the business to the place, where they can access the corresponding functionality. If the functionality is not supported, it is recommended to explain the situation to the business and provide them with instructions how to solve the issue.",
+"id": "BuiltInSimpleAction",
+"properties": {
+"additionalContent": {
+"$ref": "AdditionalContent",
+"description": "Long text from an external source that should be available to the business. Present when the type is `SHOW_ADDITIONAL_CONTENT`."
+},
+"attributeCode": {
+"description": "The attribute that needs to be updated. Present when the type is `EDIT_ITEM_ATTRIBUTE`. This field contains a code for attribute, represented in snake_case. You can find a list of product's attributes, with their codes [here](https://support.google.com/merchants/answer/7052112).",
+"type": "string"
+},
+"type": {
+"description": "The type of action that represents a functionality that is expected to be available in third-party application.",
+"enum": [
+"BUILT_IN_SIMPLE_ACTION_TYPE_UNSPECIFIED",
+"VERIFY_PHONE",
+"CLAIM_WEBSITE",
+"ADD_PRODUCTS",
+"ADD_CONTACT_INFO",
+"LINK_ADS_ACCOUNT",
+"ADD_BUSINESS_REGISTRATION_NUMBER",
+"EDIT_ITEM_ATTRIBUTE",
+"FIX_ACCOUNT_ISSUE",
+"SHOW_ADDITIONAL_CONTENT"
+],
+"enumDescriptions": [
+"Default value. Will never be provided by the API.",
+"Redirect the business to the part of your application where they can verify their phone.",
+"Redirect the business to the part of your application where they can claim their website.",
+"Redirect the business to the part of your application where they can add products.",
+"Open a form where the business can edit their contact information.",
+"Redirect the business to the part of your application where they can link ads account.",
+"Open a form where the business can add their business registration number.",
+"Open a form where the business can edit an attribute. The attribute that needs to be updated is specified in attribute_code field of the action.",
+"Redirect the business from the product issues to the diagnostic page with their account issues in your application. This action will be returned only for product issues that are caused by an account issue and thus the business should resolve the problem on the account level.",
+"Show additional content to the business. This action will be used for example to deliver a justification from national authority."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"BuiltInUserInputAction": {
+"description": "Action that is implemented and performed in (your) third-party application. The application needs to show an additional content and input form to the business. They can start the action only when they provided all required inputs. The application will request processing of the action by calling the [triggeraction method](https://developers.google.com/merchant/api/reference/rest/issueresolution_v1beta/issueresolution/triggeraction).",
+"id": "BuiltInUserInputAction",
+"properties": {
+"actionContext": {
+"description": "Contains the action's context that must be included as part of the TriggerActionPayload.action_context in TriggerActionRequest.payload to call the `triggeraction` method. The content should be treated as opaque and must not be modified.",
+"type": "string"
+},
+"flows": {
+"description": "Actions may provide multiple different flows. Business selects one that fits best to their intent. Selecting the flow is the first step in user's interaction with the action. It affects what input fields will be available and required and also how the request will be processed.",
+"items": {
+"$ref": "ActionFlow"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"Callout": {
+"description": "An important message that should be highlighted. Usually displayed as a banner.",
+"id": "Callout",
+"properties": {
+"fullMessage": {
+"$ref": "TextWithTooltip",
+"description": "A full message that needs to be shown to the business."
+},
+"styleHint": {
+"description": "Can be used to render messages with different severity in different styles. Snippets off all types contain important information that should be displayed to the business.",
+"enum": [
+"CALLOUT_STYLE_HINT_UNSPECIFIED",
+"ERROR",
+"WARNING",
+"INFO"
+],
+"enumDescriptions": [
+"Default value. Will never be provided by the API.",
+"The most important type of information highlighting problems, like an unsuccessful outcome of previously requested actions.",
+"Information warning about pending problems, risks or deadlines.",
+"Default severity for important information like pending status of previously requested action or cooldown for re-review."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"CheckboxInput": {
+"description": "Checkbox input allows the business to provide a boolean value. Corresponds to the [html input type=checkbox](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.checkbox.html#input.checkbox). If the business checks the box, the input value for the field is `true`, otherwise it is `false`. This type of input is often used as a confirmation that the business completed required steps before they are allowed to start the action. In such a case, the input field is marked as required and the button to trigger the action should stay disabled until the business checks the box.",
+"id": "CheckboxInput",
+"properties": {},
+"type": "object"
+},
+"CheckboxInputValue": {
+"description": "Value for checkbox input field.",
+"id": "CheckboxInputValue",
+"properties": {
+"value": {
+"description": "Required. True if the business checked the box field. False otherwise.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"ChoiceInput": {
+"description": "Choice input allows the business to select one of the offered choices. Some choices may be linked to additional input fields that should be displayed under or next to the choice option. The value for the additional input field needs to be provided only when the specific choice is selected by the the business. For example, additional input field can be hidden or disabled until the business selects the specific choice.",
+"id": "ChoiceInput",
+"properties": {
+"options": {
+"description": "A list of choices. Only one option can be selected.",
+"items": {
+"$ref": "ChoiceInputOption"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"ChoiceInputOption": {
+"description": "A choice that the business can select.",
+"id": "ChoiceInputOption",
+"properties": {
+"additionalInput": {
+"$ref": "InputField",
+"description": "Input that should be displayed when this option is selected. The additional input will not contain a `ChoiceInput`."
+},
+"id": {
+"description": "Not for display but need to be sent back for the selected choice option.",
+"type": "string"
+},
+"label": {
+"$ref": "TextWithTooltip",
+"description": "Short description of the choice option. There may be more information to be shown as a tooltip."
+}
+},
+"type": "object"
+},
+"ChoiceInputValue": {
+"description": "Value for choice input field.",
+"id": "ChoiceInputValue",
+"properties": {
+"choiceInputOptionId": {
+"description": "Required. Id of the option that was selected by the business.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ExternalAction": {
+"description": "Action that is implemented and performed outside of the third-party application. It should redirect the business to the provided URL of an external system where they can perform the action. For example to request a review in the Merchant Center.",
+"id": "ExternalAction",
+"properties": {
+"type": {
+"description": "The type of external action.",
+"enum": [
+"EXTERNAL_ACTION_TYPE_UNSPECIFIED",
+"REVIEW_PRODUCT_ISSUE_IN_MERCHANT_CENTER",
+"REVIEW_ACCOUNT_ISSUE_IN_MERCHANT_CENTER",
+"LEGAL_APPEAL_IN_HELP_CENTER",
+"VERIFY_IDENTITY_IN_MERCHANT_CENTER"
+],
+"enumDescriptions": [
+"Default value. Will never be provided by the API.",
+"Redirect to Merchant Center where the business can request a review for issue related to their product.",
+"Redirect to Merchant Center where the business can request a review for issue related to their account.",
+"Redirect to the form in Help Center where the business can request a legal appeal for the issue.",
+"Redirect to Merchant Center where the business can perform identity verification."
+],
+"type": "string"
+},
+"uri": {
+"description": "URL to external system, for example Merchant Center, where the business can perform the action.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"Impact": {
+"description": "Overall impact of the issue.",
+"id": "Impact",
+"properties": {
+"breakdowns": {
+"description": "Detailed impact breakdown. Explains the types of restriction the issue has in different shopping destinations and territory. If present, it should be rendered to the business. Can be shown as a mouse over dropdown or a dialog. Each breakdown item represents a group of regions with the same impact details.",
+"items": {
+"$ref": "Breakdown"
+},
+"type": "array"
+},
+"message": {
+"description": "Optional. Message summarizing the overall impact of the issue. If present, it should be rendered to the business. For example: \"Disapproves 90k offers in 25 countries\"",
+"type": "string"
+},
+"severity": {
+"description": "The severity of the issue.",
+"enum": [
+"SEVERITY_UNSPECIFIED",
+"ERROR",
+"WARNING",
+"INFO"
+],
+"enumDescriptions": [
+"Default value. Will never be provided by the API.",
+"Causes either an account suspension or an item disapproval. Errors should be resolved as soon as possible to ensure items are eligible to appear in results again.",
+"Warnings can negatively impact the performance of ads and can lead to item or account suspensions in the future unless the issue is resolved.",
+"Infos are suggested optimizations to increase data quality. Resolving these issues is recommended, but not required."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"InputField": {
+"description": "Input field that needs to be available to the business. If the field is marked as required, then a value needs to be provided for a successful processing of the request.",
+"id": "InputField",
+"properties": {
+"checkboxInput": {
+"$ref": "CheckboxInput",
+"description": "Input field to provide a boolean value. Corresponds to the [html input type=checkbox](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.checkbox.html#input.checkbox)."
+},
+"choiceInput": {
+"$ref": "ChoiceInput",
+"description": "Input field to select one of the offered choices. Corresponds to the [html input type=radio](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.radio.html#input.radio)."
+},
+"id": {
+"description": "Not for display but need to be sent back for the given input field.",
+"type": "string"
+},
+"label": {
+"$ref": "TextWithTooltip",
+"description": "Input field label. There may be more information to be shown in a tooltip."
+},
+"required": {
+"description": "Whether the field is required. The action button needs to stay disabled till values for all required fields are provided.",
+"type": "boolean"
+},
+"textInput": {
+"$ref": "TextInput",
+"description": "Input field to provide text information. Corresponds to the [html input type=text](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.text.html#input.text) or [html textarea](https://www.w3.org/TR/2012/WD-html-markup-20121025/textarea.html#textarea)."
+}
+},
+"type": "object"
+},
+"InputValue": {
+"description": "Input provided by the business for input field.",
+"id": "InputValue",
+"properties": {
+"checkboxInputValue": {
+"$ref": "CheckboxInputValue",
+"description": "Value for checkbox input field."
+},
+"choiceInputValue": {
+"$ref": "ChoiceInputValue",
+"description": "Value for choice input field."
+},
+"inputFieldId": {
+"description": "Required. Id of the corresponding input field.",
+"type": "string"
+},
+"textInputValue": {
+"$ref": "TextInputValue",
+"description": "Value for text input field."
+}
+},
+"type": "object"
+},
+"ItemLevelIssue": {
+"description": "The ItemLevelIssue of the product status.",
+"id": "ItemLevelIssue",
+"properties": {
+"attribute": {
+"description": "The attribute's name, if the issue is caused by a single attribute.",
+"type": "string"
+},
+"code": {
+"description": "The error code of the issue.",
+"type": "string"
+},
+"description": {
+"description": "A short issue description in English.",
+"type": "string"
+},
+"detail": {
+"description": "A detailed issue description in English.",
+"type": "string"
+},
+"documentationUri": {
+"description": "The URL of a web page to help with resolving this issue.",
+"type": "string"
+},
+"productCount": {
+"description": "The number of products affected by this issue.",
+"format": "int64",
+"type": "string"
+},
+"resolution": {
+"description": "Whether the issue can be resolved by the merchant.",
+"enum": [
+"RESOLUTION_UNSPECIFIED",
+"MERCHANT_ACTION",
+"PENDING_PROCESSING"
+],
+"enumDescriptions": [
+"Not specified.",
+"The issue can be resolved by the merchant.",
+"The issue will be resolved auomatically."
+],
+"type": "string"
+},
+"severity": {
+"description": "How this issue affects serving of the offer.",
+"enum": [
+"SEVERITY_UNSPECIFIED",
+"NOT_IMPACTED",
+"DEMOTED",
+"DISAPPROVED"
+],
+"enumDescriptions": [
+"Not specified.",
+"This issue represents a warning and does not have a direct affect on the product.",
+"The product is demoted and most likely have limited performance in search results",
+"Issue disapproves the product."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ListAggregateProductStatusesResponse": {
+"description": "Response message for the `ListAggregateProductStatuses` method.",
+"id": "ListAggregateProductStatusesResponse",
+"properties": {
+"aggregateProductStatuses": {
+"description": "The `AggregateProductStatuses` resources for the given account.",
+"items": {
+"$ref": "AggregateProductStatus"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductChange": {
+"description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.",
+"id": "ProductChange",
+"properties": {
+"newValue": {
+"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"oldValue": {
+"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"regionCode": {
+"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
+"type": "string"
+},
+"reportingContext": {
+"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductStatusChangeMessage": {
+"description": "The message that the merchant will receive to notify about product status change event",
+"id": "ProductStatusChangeMessage",
+"properties": {
+"account": {
+"description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`",
+"type": "string"
+},
+"attribute": {
+"description": "The attribute in the resource that changed, in this case it will be always `Status`.",
+"enum": [
+"ATTRIBUTE_UNSPECIFIED",
+"STATUS"
+],
+"enumDescriptions": [
+"Unspecified attribute",
+"Status of the changed entity"
+],
+"type": "string"
+},
+"changes": {
+"description": "A message to describe the change that happened to the product",
+"items": {
+"$ref": "ProductChange"
+},
+"type": "array"
+},
+"eventTime": {
+"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationTime": {
+"description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.",
+"format": "google-datetime",
+"type": "string"
+},
+"managingAccount": {
+"description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`",
+"type": "string"
+},
+"resource": {
+"description": "The product name. Format: `accounts/{account}/products/{product}`",
+"type": "string"
+},
+"resourceId": {
+"description": "The product id.",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource that changed, in this case it will always be `Product`.",
+"enum": [
+"RESOURCE_UNSPECIFIED",
+"PRODUCT"
+],
+"enumDescriptions": [
+"Unspecified resource",
+"Resource type : product"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"Reason": {
+"description": "A single reason why the action is not available.",
+"id": "Reason",
+"properties": {
+"action": {
+"$ref": "Action",
+"description": "Optional. An action that needs to be performed to solve the problem represented by this reason. This action will always be available. Should be rendered as a link or button next to the summarizing message. For example, the review may be available only once the business configure all required attributes. In such a situation this action can be a link to the form, where they can fill the missing attribute to unblock the main action."
+},
+"detail": {
+"description": "Detailed explanation of the reason. Should be displayed as a hint if present.",
+"type": "string"
+},
+"message": {
+"description": "Messages summarizing the reason, why the action is not available. For example: \"Review requested on Jan 03. Review requests can take a few days to complete.\"",
+"type": "string"
+}
+},
+"type": "object"
+},
+"Region": {
+"description": "Region with code and localized name.",
+"id": "Region",
+"properties": {
+"code": {
+"description": "The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml)",
+"type": "string"
+},
+"name": {
+"description": "The localized name of the region. For region with code='001' the value is 'All countries' or the equivalent in other languages.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"RenderAccountIssuesResponse": {
+"description": "Response containing an issue resolution content and actions for listed account issues.",
+"id": "RenderAccountIssuesResponse",
+"properties": {
+"renderedIssues": {
+"description": "List of account issues for a given account. This list can be shown with compressed, expandable items. In the compressed form, the title and impact should be shown for each issue. Once the issue is expanded, the detailed content and available actions should be rendered.",
+"items": {
+"$ref": "RenderedIssue"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"RenderIssuesRequestPayload": {
+"description": "The payload for configuring how the content should be rendered.",
+"id": "RenderIssuesRequestPayload",
+"properties": {
+"contentOption": {
+"description": "Optional. How the detailed content should be returned. Default option is to return the content as a pre-rendered HTML text.",
+"enum": [
+"CONTENT_OPTION_UNSPECIFIED",
+"PRE_RENDERED_HTML"
+],
+"enumDescriptions": [
+"Default value. Will never be provided by the API.",
+"Returns the detail of the issue as a pre-rendered HTML text."
+],
+"type": "string"
+},
+"userInputActionOption": {
+"description": "Optional. How actions with user input form should be handled. If not provided, actions will be returned as links that points the business to Merchant Center where they can request the action.",
+"enum": [
+"USER_INPUT_ACTION_RENDERING_OPTION_UNSPECIFIED",
+"REDIRECT_TO_MERCHANT_CENTER",
+"BUILT_IN_USER_INPUT_ACTIONS"
+],
+"enumDescriptions": [
+"Default value. Will never be provided by the API.",
+"Actions that require user input are represented only as links that points the business to Merchant Center where they can request the action. Provides easier to implement alternative to `BUILT_IN_USER_INPUT_ACTIONS`.",
+"Returns content and input form definition for each complex action. Your application needs to display this content and input form to the business before they can request processing of the action. To start the action, your application needs to call the `triggeraction` method."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"RenderProductIssuesResponse": {
+"description": "Response containing an issue resolution content and actions for listed product issues.",
+"id": "RenderProductIssuesResponse",
+"properties": {
+"renderedIssues": {
+"description": "List of issues for a given product. This list can be shown with compressed, expandable items. In the compressed form, the title and impact should be shown for each issue. Once the issue is expanded, the detailed content and available actions should be rendered.",
+"items": {
+"$ref": "RenderedIssue"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"RenderedIssue": {
+"description": "An issue affecting specific business or their product.",
+"id": "RenderedIssue",
+"properties": {
+"actions": {
+"description": "A list of actionable steps that can be executed to solve the issue. An example is requesting a re-review or providing arguments when business disagrees with the issue. Actions that are supported in (your) third-party application can be rendered as buttons and should be available to the business when they expand the issue.",
+"items": {
+"$ref": "Action"
+},
+"type": "array"
+},
+"impact": {
+"$ref": "Impact",
+"description": "Clarifies the severity of the issue. The summarizing message, if present, should be shown right under the title for each issue. It helps business to quickly understand the impact of the issue. The detailed breakdown helps the business to fully understand the impact of the issue. It can be rendered as dialog that opens when the business mouse over the summarized impact statement. Issues with different severity can be styled differently. They may use a different color or icon to signal the difference between `ERROR`, `WARNING` and `INFO`."
+},
+"prerenderedContent": {
+"description": "Details of the issue as a pre-rendered HTML. HTML elements contain CSS classes that can be used to customize the style of the content. Always sanitize the HTML before embedding it directly to your application. The sanitizer needs to allow basic HTML tags, such as: `div`, `span`, `p`, `a`, `ul`, `li`, `table`, `tr`, `td`. For example, you can use [DOMPurify](https://www.npmjs.com/package/dompurify). CSS classes: * `issue-detail` - top level container for the detail of the issue * `callout-banners` - section of the `issue-detail` with callout banners * `callout-banner` - single callout banner, inside `callout-banners` * `callout-banner-info` - callout with important information (default) * `callout-banner-warning` - callout with a warning * `callout-banner-error` - callout informing about an error (most severe) * `issue-content` - section of the `issue-detail`, contains multiple `content-element` * `content-element` - content element such as a list, link or paragraph, inside `issue-content` * `root-causes` - unordered list with items describing root causes of the issue, inside `issue-content` * `root-causes-intro` - intro text before the `root-causes` list, inside `issue-content` * `segment` - section of the text, `span` inside paragraph * `segment-attribute` - section of the text that represents a product attribute, for example 'image\\_link' * `segment-literal` - section of the text that contains a special value, for example '0-1000 kg' * `segment-bold` - section of the text that should be rendered as bold * `segment-italic` - section of the text that should be rendered as italic * `tooltip` - used on paragraphs that should be rendered with a tooltip. A section of the text in such a paragraph will have a class `tooltip-text` and is intended to be shown in a mouse over dialog. If the style is not used, the `tooltip-text` section would be shown on a new line, after the main part of the text. * `tooltip-text` - marks a section of the text within a `tooltip`, that is intended to be shown in a mouse over dialog. * `tooltip-icon` - marks a section of the text within a `tooltip`, that can be replaced with a tooltip icon, for example '?' or 'i'. By default, this section contains a `br` tag, that is separating the main text and the tooltip text when the style is not used. * `tooltip-style-question` - the tooltip shows helpful information, can use the '?' as an icon. * `tooltip-style-info` - the tooltip adds additional information fitting to the context, can use the 'i' as an icon. * `content-moderation` - marks the paragraph that explains how the issue was identified. * `new-element` - Present for new elements added to the pre-rendered content in the future. To make sure that a new content element does not break your style, you can hide everything with this class.",
+"type": "string"
+},
+"prerenderedOutOfCourtDisputeSettlement": {
+"description": "Pre-rendered HTML that contains a link to the external location where the ODS can be requested and instructions for how to request it. HTML elements contain CSS classes that can be used to customize the style of this snippet. Always sanitize the HTML before embedding it directly to your application. The sanitizer needs to allow basic HTML tags, such as: `div`, `span`, `p`, `a`, `ul`, `li`, `table`, `tr`, `td`. For example, you can use [DOMPurify](https://www.npmjs.com/package/dompurify). CSS classes: * `ods-section`* - wrapper around the out-of-court dispute resolution section * `ods-description`* - intro text for the out-of-court dispute resolution. It may contain multiple segments and a link. * `ods-param`* - wrapper around the header-value pair for parameters that the business may need to provide during the ODS process. * `ods-routing-id`* - ods param for the Routing ID. * `ods-reference-id`* - ods param for the Routing ID. * `ods-param-header`* - header for the ODS parameter * `ods-param-value`* - value of the ODS parameter. This value should be rendered in a way that it is easy for the user to identify and copy. * `segment` - section of the text, `span` inside paragraph * `segment-attribute` - section of the text that represents a product attribute, for example 'image\\_link' * `segment-literal` - section of the text that contains a special value, for example '0-1000 kg' * `segment-bold` - section of the text that should be rendered as bold * `segment-italic` - section of the text that should be rendered as italic * `tooltip` - used on paragraphs that should be rendered with a tooltip. A section of the text in such a paragraph will have a class `tooltip-text` and is intended to be shown in a mouse over dialog. If the style is not used, the `tooltip-text` section would be shown on a new line, after the main part of the text. * `tooltip-text` - marks a section of the text within a `tooltip`, that is intended to be shown in a mouse over dialog. * `tooltip-icon` - marks a section of the text within a `tooltip`, that can be replaced with a tooltip icon, for example '?' or 'i'. By default, this section contains a `br` tag, that is separating the main text and the tooltip text when the style is not used. * `tooltip-style-question` - the tooltip shows helpful information, can use the '?' as an icon. * `tooltip-style-info` - the tooltip adds additional information fitting to the context, can use the 'i' as an icon.",
+"type": "string"
+},
+"title": {
+"description": "Title of the issue.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"Stats": {
+"description": "Products statistics.",
+"id": "Stats",
+"properties": {
+"activeCount": {
+"description": "The number of products that are active.",
+"format": "int64",
+"type": "string"
+},
+"disapprovedCount": {
+"description": "The number of products that are disapproved.",
+"format": "int64",
+"type": "string"
+},
+"expiringCount": {
+"description": "The number of products that are expiring.",
+"format": "int64",
+"type": "string"
+},
+"pendingCount": {
+"description": "The number of products that are pending.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"TextInput": {
+"description": "Text input allows the business to provide a text value.",
+"id": "TextInput",
+"properties": {
+"additionalInfo": {
+"$ref": "TextWithTooltip",
+"description": "Additional info regarding the field to be displayed to the business. For example, warning to not include personal identifiable information. There may be more information to be shown in a tooltip."
+},
+"ariaLabel": {
+"description": "Text to be used as the [aria-label](https://www.w3.org/TR/WCAG20-TECHS/ARIA14.html) for the input.",
+"type": "string"
+},
+"formatInfo": {
+"description": "Information about the required format. If present, it should be shown close to the input field to help the business to provide a correct value. For example: \"VAT numbers should be in a format similar to SK9999999999\"",
+"type": "string"
+},
+"type": {
+"description": "Type of the text input",
+"enum": [
+"TEXT_INPUT_TYPE_UNSPECIFIED",
+"GENERIC_SHORT_TEXT",
+"GENERIC_LONG_TEXT"
+],
+"enumDescriptions": [
+"Default value. Will never be provided by the API.",
+"Used when a short text is expected. The field can be rendered as a [text field](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.text.html#input.text).",
+"Used when a longer text is expected. The field should be rendered as a [textarea](https://www.w3.org/TR/2012/WD-html-markup-20121025/textarea.html#textarea)."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"TextInputValue": {
+"description": "Value for text input field.",
+"id": "TextInputValue",
+"properties": {
+"value": {
+"description": "Required. Text provided by the business.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"TextWithTooltip": {
+"description": "Block of text that may contain a tooltip with more information.",
+"id": "TextWithTooltip",
+"properties": {
+"simpleTooltipValue": {
+"description": "Value of the tooltip as a simple text.",
+"type": "string"
+},
+"simpleValue": {
+"description": "Value of the message as a simple text.",
+"type": "string"
+},
+"tooltipIconStyle": {
+"description": "The suggested type of an icon for tooltip, if a tooltip is present.",
+"enum": [
+"TOOLTIP_ICON_STYLE_UNSPECIFIED",
+"INFO",
+"QUESTION"
+],
+"enumDescriptions": [
+"Default value. Will never be provided by the API.",
+"Used when the tooltip adds additional information to the context, the 'i' can be used as an icon.",
+"Used when the tooltip shows helpful information, the '?' can be used as an icon."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"TriggerActionPayload": {
+"description": "The payload for the triggered action.",
+"id": "TriggerActionPayload",
+"properties": {
+"actionContext": {
+"description": "Required. The context from the selected action. The value is obtained from rendered issues and needs to be sent back to identify the action that is being triggered.",
+"type": "string"
+},
+"actionInput": {
+"$ref": "ActionInput",
+"description": "Required. Input provided by the business."
+}
+},
+"type": "object"
+},
+"TriggerActionResponse": {
+"description": "Response informing about the started action.",
+"id": "TriggerActionResponse",
+"properties": {
+"message": {
+"description": "The message for the business.",
+"type": "string"
+}
+},
+"type": "object"
+}
+},
+"servicePath": "",
+"title": "Merchant API",
+"version": "issueresolution_v1",
+"version_module": true
+}
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.lfp_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.lfp_v1beta.json
index a2976c59217..69bdc263567 100644
--- a/googleapiclient/discovery_cache/documents/merchantapi.lfp_v1beta.json
+++ b/googleapiclient/discovery_cache/documents/merchantapi.lfp_v1beta.json
@@ -327,7 +327,7 @@
 }
 }
 },
-"revision": "20250621",
+"revision": "20250803",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "CountrySettings": {
@@ -617,7 +617,7 @@
 "id": "LfpStore",
 "properties": {
 "gcidCategory": {
-"description": "Optional. [Google My Business category id](https://gcid-explorer.corp.google.com/static/gcid.html).",
+"description": "Optional. [Google My Business category id](https://support.google.com/business/answer/7249669).",
 "items": {
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.notifications_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.notifications_v1.json
new file mode 100644
index 00000000000..942635ba308
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/merchantapi.notifications_v1.json
@@ -0,0 +1,483 @@
+{
+"auth": {
+"oauth2": {
+"scopes": {
+"https://www.googleapis.com/auth/content": {
+"description": "Manage your product listings and accounts for Google Shopping"
+}
+}
+}
+},
+"basePath": "",
+"baseUrl": "https://merchantapi.googleapis.com/",
+"batchPath": "batch",
+"canonicalName": "Merchant",
+"description": "Programmatically manage your Merchant Center Accounts.",
+"discoveryVersion": "v1",
+"documentationLink": "https://developers.google.com/merchant/api",
+"fullyEncodeReservedExpansion": true,
+"icons": {
+"x16": "http://www.google.com/images/icons/product/search-16.gif",
+"x32": "http://www.google.com/images/icons/product/search-32.gif"
+},
+"id": "merchantapi:notifications_v1",
+"kind": "discovery#restDescription",
+"mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/",
+"name": "merchantapi",
+"ownerDomain": "google.com",
+"ownerName": "Google",
+"parameters": {
+"$.xgafv": {
+"description": "V1 error format.",
+"enum": [
+"1",
+"2"
+],
+"enumDescriptions": [
+"v1 error format",
+"v2 error format"
+],
+"location": "query",
+"type": "string"
+},
+"access_token": {
+"description": "OAuth access token.",
+"location": "query",
+"type": "string"
+},
+"alt": {
+"default": "json",
+"description": "Data format for response.",
+"enum": [
+"json",
+"media",
+"proto"
+],
+"enumDescriptions": [
+"Responses with Content-Type of application/json",
+"Media download with context-dependent Content-Type",
+"Responses with Content-Type of application/x-protobuf"
+],
+"location": "query",
+"type": "string"
+},
+"callback": {
+"description": "JSONP",
+"location": "query",
+"type": "string"
+},
+"fields": {
+"description": "Selector specifying which fields to include in a partial response.",
+"location": "query",
+"type": "string"
+},
+"key": {
+"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+"location": "query",
+"type": "string"
+},
+"oauth_token": {
+"description": "OAuth 2.0 token for the current user.",
+"location": "query",
+"type": "string"
+},
+"prettyPrint": {
+"default": "true",
+"description": "Returns response with indentations and line breaks.",
+"location": "query",
+"type": "boolean"
+},
+"quotaUser": {
+"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+"location": "query",
+"type": "string"
+},
+"uploadType": {
+"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+"location": "query",
+"type": "string"
+},
+"upload_protocol": {
+"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+"location": "query",
+"type": "string"
+}
+},
+"protocol": "rest",
+"resources": {
+"accounts": {
+"resources": {
+"notificationsubscriptions": {
+"methods": {
+"create": {
+"description": "Creates a notification subscription for a business. For standalone or subaccounts accounts, the business can create a subscription for self. For MCAs, the business can create a subscription for all managed accounts or for a specific subaccount. We will allow the following types of notification subscriptions to exist together (per business as a subscriber per event type): 1. Subscription for all managed accounts + subscription for self. 2. Multiple \"partial\" subscriptions for managed accounts + subscription for self. we will not allow (per business as a subscriber per event type): 1. Multiple self subscriptions. 2. Multiple \"all managed accounts\" subscriptions. 3. \"All managed accounts\" subscription and partial subscriptions at the same time. 4. Multiple partial subscriptions for the same target account.",
+"flatPath": "notifications/v1/accounts/{accountsId}/notificationsubscriptions",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.notificationsubscriptions.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The merchant account that owns the new notification subscription. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "notifications/v1/{+parent}/notificationsubscriptions",
+"request": {
+"$ref": "NotificationSubscription"
+},
+"response": {
+"$ref": "NotificationSubscription"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"delete": {
+"description": "Deletes a notification subscription for a merchant.",
+"flatPath": "notifications/v1/accounts/{accountsId}/notificationsubscriptions/{notificationsubscriptionsId}",
+"httpMethod": "DELETE",
+"id": "merchantapi.accounts.notificationsubscriptions.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the notification subscription to be deleted.",
+"location": "path",
+"pattern": "^accounts/[^/]+/notificationsubscriptions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "notifications/v1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"get": {
+"description": "Gets notification subscriptions for an account.",
+"flatPath": "notifications/v1/accounts/{accountsId}/notificationsubscriptions/{notificationsubscriptionsId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.notificationsubscriptions.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The `name` of the notification subscription.",
+"location": "path",
+"pattern": "^accounts/[^/]+/notificationsubscriptions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "notifications/v1/{+name}",
+"response": {
+"$ref": "NotificationSubscription"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "Gets all the notification subscriptions for a merchant.",
+"flatPath": "notifications/v1/accounts/{accountsId}/notificationsubscriptions",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.notificationsubscriptions.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "The maximum number of notification subscriptions to return in a page. The default value for `page_size` is 100. The maximum value is `200`. Values above `200` will be coerced to `200`.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The merchant account who owns the notification subscriptions. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "notifications/v1/{+parent}/notificationsubscriptions",
+"response": {
+"$ref": "ListNotificationSubscriptionsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"patch": {
+"description": "Updates an existing notification subscription for a merchant.",
+"flatPath": "notifications/v1/accounts/{accountsId}/notificationsubscriptions/{notificationsubscriptionsId}",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.notificationsubscriptions.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Output only. The `name` of the notification configuration. Generated by the Content API upon creation of a new `NotificationSubscription`. The `account` represents the merchant ID of the merchant that owns the configuration. Format: `accounts/{account}/notificationsubscriptions/{notification_subscription}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/notificationsubscriptions/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "List of fields being updated.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "notifications/v1/{+name}",
+"request": {
+"$ref": "NotificationSubscription"
+},
+"response": {
+"$ref": "NotificationSubscription"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+}
+},
+"revision": "20250804",
+"rootUrl": "https://merchantapi.googleapis.com/",
+"schemas": {
+"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",
+"properties": {},
+"type": "object"
+},
+"ListNotificationSubscriptionsResponse": {
+"description": "Response message for the ListNotificationSubscription method.",
+"id": "ListNotificationSubscriptionsResponse",
+"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"
+},
+"notificationSubscriptions": {
+"description": "The list of notification subscriptions requested by the merchant.",
+"items": {
+"$ref": "NotificationSubscription"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"NotificationSubscription": {
+"description": "Represents a notification subscription owned by a Merchant account.",
+"id": "NotificationSubscription",
+"properties": {
+"allManagedAccounts": {
+"description": "If this value is true, the requesting account is notified of the specified event for all managed accounts (can be subaccounts or other linked accounts) including newly added accounts on a daily basis.",
+"type": "boolean"
+},
+"callBackUri": {
+"description": "URL to be used to push the notification to the merchant.",
+"type": "string"
+},
+"name": {
+"description": "Output only. The `name` of the notification configuration. Generated by the Content API upon creation of a new `NotificationSubscription`. The `account` represents the merchant ID of the merchant that owns the configuration. Format: `accounts/{account}/notificationsubscriptions/{notification_subscription}`",
+"readOnly": true,
+"type": "string"
+},
+"registeredEvent": {
+"description": "The event that the merchant wants to be notified about.",
+"enum": [
+"NOTIFICATION_EVENT_TYPE_UNSPECIFIED",
+"PRODUCT_STATUS_CHANGE"
+],
+"enumDescriptions": [
+"Notifications event type is unspecified.",
+"Notification of product status changes, for example when product becomes disapproved."
+],
+"type": "string"
+},
+"targetAccount": {
+"description": "The `name` of the account you want to receive notifications for. Format: `accounts/{account}`",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductChange": {
+"description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.",
+"id": "ProductChange",
+"properties": {
+"newValue": {
+"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"oldValue": {
+"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"regionCode": {
+"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
+"type": "string"
+},
+"reportingContext": {
+"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductStatusChangeMessage": {
+"description": "The message that the merchant will receive to notify about product status change event",
+"id": "ProductStatusChangeMessage",
+"properties": {
+"account": {
+"description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`",
+"type": "string"
+},
+"attribute": {
+"description": "The attribute in the resource that changed, in this case it will be always `Status`.",
+"enum": [
+"ATTRIBUTE_UNSPECIFIED",
+"STATUS"
+],
+"enumDescriptions": [
+"Unspecified attribute",
+"Status of the changed entity"
+],
+"type": "string"
+},
+"changes": {
+"description": "A message to describe the change that happened to the product",
+"items": {
+"$ref": "ProductChange"
+},
+"type": "array"
+},
+"eventTime": {
+"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationTime": {
+"description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.",
+"format": "google-datetime",
+"type": "string"
+},
+"managingAccount": {
+"description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`",
+"type": "string"
+},
+"resource": {
+"description": "The product name. Format: `accounts/{account}/products/{product}`",
+"type": "string"
+},
+"resourceId": {
+"description": "The product id.",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource that changed, in this case it will always be `Product`.",
+"enum": [
+"RESOURCE_UNSPECIFIED",
+"PRODUCT"
+],
+"enumDescriptions": [
+"Unspecified resource",
+"Resource type : product"
+],
+"type": "string"
+}
+},
+"type": "object"
+}
+},
+"servicePath": "",
+"title": "Merchant API",
+"version": "notifications_v1",
+"version_module": true
+}
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1.json
new file mode 100644
index 00000000000..6a2ae21ce0f
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1.json
@@ -0,0 +1,569 @@
+{
+"auth": {
+"oauth2": {
+"scopes": {
+"https://www.googleapis.com/auth/content": {
+"description": "Manage your product listings and accounts for Google Shopping"
+}
+}
+}
+},
+"basePath": "",
+"baseUrl": "https://merchantapi.googleapis.com/",
+"batchPath": "batch",
+"canonicalName": "Merchant",
+"description": "Programmatically manage your Merchant Center Accounts.",
+"discoveryVersion": "v1",
+"documentationLink": "https://developers.google.com/merchant/api",
+"fullyEncodeReservedExpansion": true,
+"icons": {
+"x16": "http://www.google.com/images/icons/product/search-16.gif",
+"x32": "http://www.google.com/images/icons/product/search-32.gif"
+},
+"id": "merchantapi:ordertracking_v1",
+"kind": "discovery#restDescription",
+"mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/",
+"name": "merchantapi",
+"ownerDomain": "google.com",
+"ownerName": "Google",
+"parameters": {
+"$.xgafv": {
+"description": "V1 error format.",
+"enum": [
+"1",
+"2"
+],
+"enumDescriptions": [
+"v1 error format",
+"v2 error format"
+],
+"location": "query",
+"type": "string"
+},
+"access_token": {
+"description": "OAuth access token.",
+"location": "query",
+"type": "string"
+},
+"alt": {
+"default": "json",
+"description": "Data format for response.",
+"enum": [
+"json",
+"media",
+"proto"
+],
+"enumDescriptions": [
+"Responses with Content-Type of application/json",
+"Media download with context-dependent Content-Type",
+"Responses with Content-Type of application/x-protobuf"
+],
+"location": "query",
+"type": "string"
+},
+"callback": {
+"description": "JSONP",
+"location": "query",
+"type": "string"
+},
+"fields": {
+"description": "Selector specifying which fields to include in a partial response.",
+"location": "query",
+"type": "string"
+},
+"key": {
+"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+"location": "query",
+"type": "string"
+},
+"oauth_token": {
+"description": "OAuth 2.0 token for the current user.",
+"location": "query",
+"type": "string"
+},
+"prettyPrint": {
+"default": "true",
+"description": "Returns response with indentations and line breaks.",
+"location": "query",
+"type": "boolean"
+},
+"quotaUser": {
+"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+"location": "query",
+"type": "string"
+},
+"uploadType": {
+"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+"location": "query",
+"type": "string"
+},
+"upload_protocol": {
+"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+"location": "query",
+"type": "string"
+}
+},
+"protocol": "rest",
+"resources": {
+"accounts": {
+"resources": {
+"orderTrackingSignals": {
+"methods": {
+"create": {
+"description": "Creates new order tracking signal.",
+"flatPath": "ordertracking/v1/accounts/{accountsId}/orderTrackingSignals",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.orderTrackingSignals.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"orderTrackingSignalId": {
+"description": "Output only. The ID that uniquely identifies this order tracking signal.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The account of the business for which the order signal is created. Format: accounts/{account}",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "ordertracking/v1/{+parent}/orderTrackingSignals",
+"request": {
+"$ref": "OrderTrackingSignal"
+},
+"response": {
+"$ref": "OrderTrackingSignal"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+}
+},
+"revision": "20250805",
+"rootUrl": "https://merchantapi.googleapis.com/",
+"schemas": {
+"DateTime": {
+"description": "Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations.",
+"id": "DateTime",
+"properties": {
+"day": {
+"description": "Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.",
+"format": "int32",
+"type": "integer"
+},
+"hours": {
+"description": "Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.",
+"format": "int32",
+"type": "integer"
+},
+"minutes": {
+"description": "Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.",
+"format": "int32",
+"type": "integer"
+},
+"month": {
+"description": "Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.",
+"format": "int32",
+"type": "integer"
+},
+"nanos": {
+"description": "Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.",
+"format": "int32",
+"type": "integer"
+},
+"seconds": {
+"description": "Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.",
+"format": "int32",
+"type": "integer"
+},
+"timeZone": {
+"$ref": "TimeZone",
+"description": "Time zone."
+},
+"utcOffset": {
+"description": "UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.",
+"format": "google-duration",
+"type": "string"
+},
+"year": {
+"description": "Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
+"LineItemDetails": {
+"description": "The line items of the order.",
+"id": "LineItemDetails",
+"properties": {
+"brand": {
+"description": "Optional. Brand of the product.",
+"type": "string"
+},
+"gtins": {
+"description": "Optional. The Global Trade Item Numbers.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"lineItemId": {
+"description": "Required. The ID for this line item.",
+"type": "string"
+},
+"mpn": {
+"description": "Optional. The manufacturer part number.",
+"type": "string"
+},
+"productId": {
+"description": "Required. The Content API REST ID of the product, in the form channel:contentLanguage:targetCountry:offerId.",
+"type": "string"
+},
+"productTitle": {
+"description": "Optional. Plain text title of this product.",
+"type": "string"
+},
+"quantity": {
+"description": "Required. The quantity of the line item in the order.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"OrderTrackingSignal": {
+"description": "Represents a business trade from which signals are extracted, such as shipping.",
+"id": "OrderTrackingSignal",
+"properties": {
+"customerShippingFee": {
+"$ref": "Price",
+"description": "Optional. The shipping fee of the order; this value should be set to zero in the case of free shipping."
+},
+"deliveryPostalCode": {
+"description": "Optional. The delivery postal code, as a continuous string without spaces or dashes, for example \"95016\". This field will be anonymized in returned OrderTrackingSignal creation response.",
+"type": "string"
+},
+"deliveryRegionCode": {
+"description": "Optional. The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) for the shipping destination.",
+"type": "string"
+},
+"lineItems": {
+"description": "Required. Information about line items in the order.",
+"items": {
+"$ref": "LineItemDetails"
+},
+"type": "array"
+},
+"merchantId": {
+"description": "Optional. The Google Merchant Center ID of this order tracking signal. This value is optional. If left unset, the caller's Merchant Center ID is used. You must request access in order to provide data on behalf of another business. For more information, see [Submitting Order Tracking Signals](/shopping-content/guides/order-tracking-signals).",
+"format": "int64",
+"type": "string"
+},
+"orderCreatedTime": {
+"$ref": "DateTime",
+"description": "Required. The time when the order was created on the businesses side. Include the year and timezone string, if available."
+},
+"orderId": {
+"description": "Required. The ID of the order on the businesses side. This field will be hashed in returned OrderTrackingSignal creation response.",
+"type": "string"
+},
+"orderTrackingSignalId": {
+"description": "Output only. The ID that uniquely identifies this order tracking signal.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"shipmentLineItemMapping": {
+"description": "Optional. The mapping of the line items to the shipment information.",
+"items": {
+"$ref": "ShipmentLineItemMapping"
+},
+"type": "array"
+},
+"shippingInfo": {
+"description": "Required. The shipping information for the order.",
+"items": {
+"$ref": "ShippingInfo"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"Price": {
+"description": "The price represented as a number and currency.",
+"id": "Price",
+"properties": {
+"amountMicros": {
+"description": "The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).",
+"format": "int64",
+"type": "string"
+},
+"currencyCode": {
+"description": "The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductChange": {
+"description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.",
+"id": "ProductChange",
+"properties": {
+"newValue": {
+"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"oldValue": {
+"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"regionCode": {
+"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
+"type": "string"
+},
+"reportingContext": {
+"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductStatusChangeMessage": {
+"description": "The message that the merchant will receive to notify about product status change event",
+"id": "ProductStatusChangeMessage",
+"properties": {
+"account": {
+"description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`",
+"type": "string"
+},
+"attribute": {
+"description": "The attribute in the resource that changed, in this case it will be always `Status`.",
+"enum": [
+"ATTRIBUTE_UNSPECIFIED",
+"STATUS"
+],
+"enumDescriptions": [
+"Unspecified attribute",
+"Status of the changed entity"
+],
+"type": "string"
+},
+"changes": {
+"description": "A message to describe the change that happened to the product",
+"items": {
+"$ref": "ProductChange"
+},
+"type": "array"
+},
+"eventTime": {
+"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationTime": {
+"description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.",
+"format": "google-datetime",
+"type": "string"
+},
+"managingAccount": {
+"description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`",
+"type": "string"
+},
+"resource": {
+"description": "The product name. Format: `accounts/{account}/products/{product}`",
+"type": "string"
+},
+"resourceId": {
+"description": "The product id.",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource that changed, in this case it will always be `Product`.",
+"enum": [
+"RESOURCE_UNSPECIFIED",
+"PRODUCT"
+],
+"enumDescriptions": [
+"Unspecified resource",
+"Resource type : product"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ShipmentLineItemMapping": {
+"description": "Represents how many items are in the shipment for the given shipment_id and line_item_id.",
+"id": "ShipmentLineItemMapping",
+"properties": {
+"lineItemId": {
+"description": "Required. The line item ID.",
+"type": "string"
+},
+"quantity": {
+"description": "Required. The line item quantity in the shipment.",
+"format": "int64",
+"type": "string"
+},
+"shipmentId": {
+"description": "Required. The shipment ID. This field will be hashed in returned OrderTrackingSignal creation response.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ShippingInfo": {
+"description": "The shipping information for the order.",
+"id": "ShippingInfo",
+"properties": {
+"actualDeliveryTime": {
+"$ref": "DateTime",
+"description": "Optional. The time when the shipment was actually delivered. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name."
+},
+"carrier": {
+"description": "Optional. The name of the shipping carrier for the delivery. This field is required if one of the following fields is absent: earliest_delivery_promise_time, latest_delivery_promise_time, and actual_delivery_time.",
+"type": "string"
+},
+"carrierService": {
+"description": "Optional. The service type for fulfillment, such as GROUND, FIRST_CLASS, etc.",
+"type": "string"
+},
+"earliestDeliveryPromiseTime": {
+"$ref": "DateTime",
+"description": "Optional. The earliest delivery promised time. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name."
+},
+"latestDeliveryPromiseTime": {
+"$ref": "DateTime",
+"description": "Optional. The latest delivery promised time. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name."
+},
+"originPostalCode": {
+"description": "Required. The origin postal code, as a continuous string without spaces or dashes, for example \"95016\". This field will be anonymized in returned OrderTrackingSignal creation response.",
+"type": "string"
+},
+"originRegionCode": {
+"description": "Required. The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) for the shipping origin.",
+"type": "string"
+},
+"shipmentId": {
+"description": "Required. The shipment ID. This field will be hashed in returned OrderTrackingSignal creation response.",
+"type": "string"
+},
+"shippedTime": {
+"$ref": "DateTime",
+"description": "Optional. The time when the shipment was shipped. Include the year and timezone string, if available."
+},
+"shippingStatus": {
+"description": "Required. The status of the shipment.",
+"enum": [
+"SHIPPING_STATE_UNSPECIFIED",
+"SHIPPED",
+"DELIVERED"
+],
+"enumDescriptions": [
+"The shipping status is not known to business.",
+"All items are shipped.",
+"The shipment is already delivered."
+],
+"type": "string"
+},
+"trackingId": {
+"description": "Optional. The tracking ID of the shipment. This field is required if one of the following fields is absent: earliest_delivery_promise_time, latest_delivery_promise_time, and actual_delivery_time.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"TimeZone": {
+"description": "Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones).",
+"id": "TimeZone",
+"properties": {
+"id": {
+"description": "IANA Time Zone Database time zone. For example \"America/New_York\".",
+"type": "string"
+},
+"version": {
+"description": "Optional. IANA Time Zone Database version number. For example \"2019a\".",
+"type": "string"
+}
+},
+"type": "object"
+}
+},
+"servicePath": "",
+"title": "Merchant API",
+"version": "ordertracking_v1",
+"version_module": true
+}
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1beta.json
index 0a7a533ef9b..fd154fa2e5e 100644
--- a/googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1beta.json
+++ b/googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1beta.json
@@ -147,7 +147,7 @@
 }
 }
 },
-"revision": "20250727",
+"revision": "20250805",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "DateTime": {
@@ -210,9 +210,17 @@
 "type": "string"
 },
 "gtin": {
+"deprecated": true,
 "description": "Optional. The Global Trade Item Number.",
 "type": "string"
 },
+"gtins": {
+"description": "Optional. The Global Trade Item Numbers.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "lineItemId": {
 "description": "Required. The ID for this line item.",
 "type": "string"
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.products_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.products_v1.json
new file mode 100644
index 00000000000..51eb829a807
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/merchantapi.products_v1.json
@@ -0,0 +1,2125 @@
+{
+"auth": {
+"oauth2": {
+"scopes": {
+"https://www.googleapis.com/auth/content": {
+"description": "Manage your product listings and accounts for Google Shopping"
+}
+}
+}
+},
+"basePath": "",
+"baseUrl": "https://merchantapi.googleapis.com/",
+"batchPath": "batch",
+"canonicalName": "Merchant",
+"description": "Programmatically manage your Merchant Center Accounts.",
+"discoveryVersion": "v1",
+"documentationLink": "https://developers.google.com/merchant/api",
+"fullyEncodeReservedExpansion": true,
+"icons": {
+"x16": "http://www.google.com/images/icons/product/search-16.gif",
+"x32": "http://www.google.com/images/icons/product/search-32.gif"
+},
+"id": "merchantapi:products_v1",
+"kind": "discovery#restDescription",
+"mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/",
+"name": "merchantapi",
+"ownerDomain": "google.com",
+"ownerName": "Google",
+"parameters": {
+"$.xgafv": {
+"description": "V1 error format.",
+"enum": [
+"1",
+"2"
+],
+"enumDescriptions": [
+"v1 error format",
+"v2 error format"
+],
+"location": "query",
+"type": "string"
+},
+"access_token": {
+"description": "OAuth access token.",
+"location": "query",
+"type": "string"
+},
+"alt": {
+"default": "json",
+"description": "Data format for response.",
+"enum": [
+"json",
+"media",
+"proto"
+],
+"enumDescriptions": [
+"Responses with Content-Type of application/json",
+"Media download with context-dependent Content-Type",
+"Responses with Content-Type of application/x-protobuf"
+],
+"location": "query",
+"type": "string"
+},
+"callback": {
+"description": "JSONP",
+"location": "query",
+"type": "string"
+},
+"fields": {
+"description": "Selector specifying which fields to include in a partial response.",
+"location": "query",
+"type": "string"
+},
+"key": {
+"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+"location": "query",
+"type": "string"
+},
+"oauth_token": {
+"description": "OAuth 2.0 token for the current user.",
+"location": "query",
+"type": "string"
+},
+"prettyPrint": {
+"default": "true",
+"description": "Returns response with indentations and line breaks.",
+"location": "query",
+"type": "boolean"
+},
+"quotaUser": {
+"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+"location": "query",
+"type": "string"
+},
+"uploadType": {
+"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+"location": "query",
+"type": "string"
+},
+"upload_protocol": {
+"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+"location": "query",
+"type": "string"
+}
+},
+"protocol": "rest",
+"resources": {
+"accounts": {
+"resources": {
+"productInputs": {
+"methods": {
+"delete": {
+"description": "Deletes a product input from your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.",
+"flatPath": "products/v1/accounts/{accountsId}/productInputs/{productInputsId}",
+"httpMethod": "DELETE",
+"id": "merchantapi.accounts.productInputs.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"dataSource": {
+"description": "Required. The primary or supplemental data source from which the product input should be deleted. Format: `accounts/{account}/dataSources/{datasource}`. For example, `accounts/123456/dataSources/104628`.",
+"location": "query",
+"type": "string"
+},
+"name": {
+"description": "Required. The name of the product input resource to delete. Format: `accounts/{account}/productInputs/{product}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/productInputs/en~US~sku123`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/productInputs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "products/v1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"insert": {
+"description": "[Uploads a product input to your Merchant Center account](/merchant/api/guides/products/overview#upload-product-input). You must have a products [data source](/merchant/api/guides/data-sources/overview) to be able to insert a product. The unique identifier of the data source is passed as a query parameter in the request URL. If a product input with the same contentLanguage, offerId, and dataSource already exists, then the product input inserted by this method replaces that entry. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.",
+"flatPath": "products/v1/accounts/{accountsId}/productInputs:insert",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.productInputs.insert",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"dataSource": {
+"description": "Required. The primary or supplemental product data source name. If the product already exists and data source provided is different, then the product will be moved to a new data source. For more information, see [Overview of Data sources sub-API](/merchant/api/guides/data-sources/overview). Only API data sources are supported. Format: `accounts/{account}/dataSources/{datasource}`. For example, `accounts/123456/dataSources/104628`.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The account where this product will be inserted. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "products/v1/{+parent}/productInputs:insert",
+"request": {
+"$ref": "ProductInput"
+},
+"response": {
+"$ref": "ProductInput"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"patch": {
+"description": "Updates the existing product input in your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.",
+"flatPath": "products/v1/accounts/{accountsId}/productInputs/{productInputsId}",
+"httpMethod": "PATCH",
+"id": "merchantapi.accounts.productInputs.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"dataSource": {
+"description": "Required. The primary or supplemental product data source where `data_source` name identifies the product input to be updated. Only API data sources are supported. Format: `accounts/{account}/dataSources/{datasource}`. For example, `accounts/123456/dataSources/104628`.",
+"location": "query",
+"type": "string"
+},
+"name": {
+"description": "Identifier. The name of the product input. Format: `accounts/{account}/productInputs/{productinput}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/productInputs/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. The list of product attributes to be updated. If the update mask is omitted, then it is treated as implied field mask equivalent to all fields that are populated (have a non-empty value). Attributes specified in the update mask without a value specified in the body will be deleted from the product. Update mask can only be specified for top level fields in attributes and custom attributes. To specify the update mask for custom attributes you need to add the `custom_attribute.` prefix. Providing special \"*\" value for full product replacement is not supported.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "products/v1/{+name}",
+"request": {
+"$ref": "ProductInput"
+},
+"response": {
+"$ref": "ProductInput"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+},
+"products": {
+"methods": {
+"get": {
+"description": "Retrieves the processed product from your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the updated final product can be retrieved.",
+"flatPath": "products/v1/accounts/{accountsId}/products/{productsId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.products.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the product to retrieve. Format: `accounts/{account}/products/{product}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/products/en~US~sku123`. A legacy local product name would be `accounts/123/products/local~en~US~sku123`. Note: For calls to the v1beta version, the `product` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/products/online~en~US~sku123`.",
+"location": "path",
+"pattern": "^accounts/[^/]+/products/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "products/v1/{+name}",
+"response": {
+"$ref": "Product"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "Lists the processed products in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested. After inserting, updating, or deleting a product input, it may take several minutes before the updated processed product can be retrieved.",
+"flatPath": "products/v1/accounts/{accountsId}/products",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.products.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "The maximum number of products to return. The service may return fewer than this value. The maximum value is 1000; values above 1000 will be coerced to 1000. If unspecified, the default page size of 25 products will be returned.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "A page token, received from a previous `ListProducts` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListProducts` must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The account to list processed products for. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "products/v1/{+parent}/products",
+"response": {
+"$ref": "ListProductsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+}
+},
+"revision": "20250804",
+"rootUrl": "https://merchantapi.googleapis.com/",
+"schemas": {
+"AutomatedDiscounts": {
+"description": "Information regarding Automated Discounts.",
+"id": "AutomatedDiscounts",
+"properties": {
+"gadPrice": {
+"$ref": "Price",
+"description": "The current sale price for products with a price optimized using Google Automated Discounts (GAD). Absent if the information about the GAD_price of the product is not available."
+},
+"priorPrice": {
+"$ref": "Price",
+"description": "The price prior to the application of the first price reduction. Absent if the information about the prior price of the product is not available."
+},
+"priorPriceProgressive": {
+"$ref": "Price",
+"description": "The price prior to the application of consecutive price reductions. Absent if the information about the prior price of the product is not available."
+}
+},
+"type": "object"
+},
+"CloudExportAdditionalProperties": {
+"description": "Product property for the Cloud Retail API. For example, properties for a TV product could be \"Screen-Resolution\" or \"Screen-Size\".",
+"id": "CloudExportAdditionalProperties",
+"properties": {
+"boolValue": {
+"description": "Boolean value of the given property. For example for a TV product, \"True\" or \"False\" if the screen is UHD.",
+"type": "boolean"
+},
+"floatValue": {
+"description": "Float values of the given property. For example for a TV product 1.2345. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.",
+"items": {
+"format": "float",
+"type": "number"
+},
+"type": "array"
+},
+"intValue": {
+"description": "Integer values of the given property. For example, 1080 for a TV product's Screen Resolution. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order.",
+"items": {
+"format": "int64",
+"type": "string"
+},
+"type": "array"
+},
+"maxValue": {
+"description": "Maximum float value of the given property. For example for a TV product 100.00.",
+"format": "float",
+"type": "number"
+},
+"minValue": {
+"description": "Minimum float value of the given property. For example for a TV product 1.00.",
+"format": "float",
+"type": "number"
+},
+"propertyName": {
+"description": "Name of the given property. For example, \"Screen-Resolution\" for a TV product. Maximum string size is 256 characters.",
+"type": "string"
+},
+"textValue": {
+"description": "Text value of the given property. For example, \"8K(UHD)\" could be a text value for a TV product. Maximum repeatedness of this value is 400. Values are stored in an arbitrary but consistent order. Maximum string size is 256 characters.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"unitCode": {
+"description": "Unit of the given property. For example, \"Pixels\" for a TV product. Maximum string size is 256B.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"CustomAttribute": {
+"description": "A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.",
+"id": "CustomAttribute",
+"properties": {
+"groupValues": {
+"description": "Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.",
+"items": {
+"$ref": "CustomAttribute"
+},
+"type": "array"
+},
+"name": {
+"description": "The name of the attribute.",
+"type": "string"
+},
+"value": {
+"description": "The value of the attribute. If `value` is not empty, `group_values` must be empty.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"DestinationStatus": {
+"description": "The destination status of the product status.",
+"id": "DestinationStatus",
+"properties": {
+"approvedCountries": {
+"description": "List of country codes (ISO 3166-1 alpha-2) where the offer is approved.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"disapprovedCountries": {
+"description": "List of country codes (ISO 3166-1 alpha-2) where the offer is disapproved.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"pendingCountries": {
+"description": "List of country codes (ISO 3166-1 alpha-2) where the offer is pending approval.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"reportingContext": {
+"description": "The name of the reporting context.",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"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",
+"properties": {},
+"type": "object"
+},
+"FreeShippingThreshold": {
+"description": "Conditions to be met for a product to have free shipping.",
+"id": "FreeShippingThreshold",
+"properties": {
+"country": {
+"description": "The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.",
+"type": "string"
+},
+"priceThreshold": {
+"$ref": "Price",
+"description": "The minimum product price for the shipping cost to become free. Represented as a number."
+}
+},
+"type": "object"
+},
+"Interval": {
+"description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.",
+"id": "Interval",
+"properties": {
+"endTime": {
+"description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.",
+"format": "google-datetime",
+"type": "string"
+},
+"startTime": {
+"description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ItemLevelIssue": {
+"description": "The ItemLevelIssue of the product status.",
+"id": "ItemLevelIssue",
+"properties": {
+"applicableCountries": {
+"description": "List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"attribute": {
+"description": "The attribute's name, if the issue is caused by a single attribute.",
+"type": "string"
+},
+"code": {
+"description": "The error code of the issue.",
+"type": "string"
+},
+"description": {
+"description": "A short issue description in English.",
+"type": "string"
+},
+"detail": {
+"description": "A detailed issue description in English.",
+"type": "string"
+},
+"documentation": {
+"description": "The URL of a web page to help with resolving this issue.",
+"type": "string"
+},
+"reportingContext": {
+"description": "The reporting context the issue applies to.",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+},
+"resolution": {
+"description": "Whether the issue can be resolved by the business.",
+"type": "string"
+},
+"severity": {
+"description": "How this issue affects serving of the offer.",
+"enum": [
+"SEVERITY_UNSPECIFIED",
+"NOT_IMPACTED",
+"DEMOTED",
+"DISAPPROVED"
+],
+"enumDescriptions": [
+"Not specified.",
+"This issue represents a warning and does not have a direct affect on the product.",
+"The product is demoted and most likely have limited performance in search results",
+"Issue disapproves the product."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ListProductsResponse": {
+"description": "Response message for the ListProducts method.",
+"id": "ListProductsResponse",
+"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"
+},
+"products": {
+"description": "The processed products from the specified account. These are your processed products after applying rules and supplemental data sources.",
+"items": {
+"$ref": "Product"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"LoyaltyPoints": {
+"description": "A message that represents loyalty points.",
+"id": "LoyaltyPoints",
+"properties": {
+"name": {
+"description": "Name of loyalty points program. It is recommended to limit the name to 12 full-width characters or 24 Roman characters.",
+"type": "string"
+},
+"pointsValue": {
+"description": "The retailer's loyalty points in absolute value.",
+"format": "int64",
+"type": "string"
+},
+"ratio": {
+"description": "The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"LoyaltyProgram": {
+"description": "A message that represents loyalty program.",
+"id": "LoyaltyProgram",
+"properties": {
+"cashbackForFutureUse": {
+"$ref": "Price",
+"description": "The cashback that can be used for future purchases."
+},
+"loyaltyPoints": {
+"description": "The amount of loyalty points earned on a purchase.",
+"format": "int64",
+"type": "string"
+},
+"memberPriceEffectiveDate": {
+"$ref": "Interval",
+"description": "A date range during which the item is eligible for member price. If not specified, the member price is always applicable. The date range is represented by a pair of ISO 8601 dates separated by a space, comma, or slash."
+},
+"price": {
+"$ref": "Price",
+"description": "The price for members of the given tier, that is, the instant discount price. Must be smaller or equal to the regular price."
+},
+"programLabel": {
+"description": "The label of the loyalty program. This is an internal label that uniquely identifies the relationship between a business entity and a loyalty program entity. The label must be provided so that the system can associate the assets below (for example, price and points) with a business. The corresponding program must be linked to the Merchant Center account.",
+"type": "string"
+},
+"shippingLabel": {
+"description": "The label of the shipping benefit. If the field has value, this offer has loyalty shipping benefit. If the field value isn't provided, the item is not eligible for loyalty shipping for the given loyalty tier.",
+"type": "string"
+},
+"tierLabel": {
+"description": "The label of the tier within the loyalty program. Must match one of the labels within the program.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"Price": {
+"description": "The price represented as a number and currency.",
+"id": "Price",
+"properties": {
+"amountMicros": {
+"description": "The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).",
+"format": "int64",
+"type": "string"
+},
+"currencyCode": {
+"description": "The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"Product": {
+"description": "The processed product, built from multiple product inputs after applying rules and supplemental data sources. This processed product matches what is shown in your Merchant Center account. Each product is built from exactly one primary data source product input, and multiple supplemental data source inputs. After inserting, updating, or deleting a product input, it may take several minutes before the updated processed product can be retrieved. All fields in the processed product and its sub-messages match the name of their corresponding attribute in the [Product data specification](https://support.google.com/merchants/answer/7052112) with some exceptions.",
+"id": "Product",
+"properties": {
+"automatedDiscounts": {
+"$ref": "AutomatedDiscounts",
+"description": "Output only. The automated discounts information for the product.",
+"readOnly": true
+},
+"contentLanguage": {
+"description": "Output only. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the product.",
+"readOnly": true,
+"type": "string"
+},
+"customAttributes": {
+"description": "Output only. A list of custom (merchant-provided) attributes. It can also be used to submit any attribute of the data specification in its generic form (for example, `{ \"name\": \"size type\", \"value\": \"regular\" }`). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google.",
+"items": {
+"$ref": "CustomAttribute"
+},
+"readOnly": true,
+"type": "array"
+},
+"dataSource": {
+"description": "Output only. The primary data source of the product.",
+"readOnly": true,
+"type": "string"
+},
+"feedLabel": {
+"description": "Output only. The feed label lets you categorize and identify your products. The maximum allowed characters is 20 and the supported characters are`A-Z`, `0-9`, hyphen and underscore. The feed label must not include any spaces. For more information, see [Using feed labels](//support.google.com/merchants/answer/14994087)",
+"readOnly": true,
+"type": "string"
+},
+"legacyLocal": {
+"description": "Output only. Determines whether the product is **only** targeting local destinations and whether the product name should be distinguished with a `local~` prefix. For example, `accounts/123/products/local~en~US~sku123`.",
+"readOnly": true,
+"type": "boolean"
+},
+"name": {
+"description": "The name of the product. Format: `accounts/{account}/products/{product}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/products/en~US~sku123`. A legacy local product name would be `accounts/123/products/local~en~US~sku123`. Note: For calls to the v1beta version, the `product` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/products/online~en~US~sku123`.",
+"type": "string"
+},
+"offerId": {
+"description": "Output only. Your unique identifier for the product. This is the same for the product input and processed product. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. See the [product data specification](https://support.google.com/merchants/answer/188494#id) for details.",
+"readOnly": true,
+"type": "string"
+},
+"productAttributes": {
+"$ref": "ProductAttributes",
+"description": "Output only. A list of strongly-typed product attributes.",
+"readOnly": true
+},
+"productStatus": {
+"$ref": "ProductStatus",
+"description": "Output only. The status of a product, data validation issues, that is, information about a product computed asynchronously.",
+"readOnly": true
+},
+"versionNumber": {
+"description": "Output only. Represents the existing version (freshness) of the product, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing product. Re-insertion (for example, product refresh after 30 days) can be performed with the current `version_number`. Only supported for insertions into primary data sources. If the operation is prevented, the aborted exception will be thrown.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductAttributes": {
+"description": "Product attributes.",
+"id": "ProductAttributes",
+"properties": {
+"additionalImageLinks": {
+"description": "Additional URLs of images of the item.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"adsGrouping": {
+"description": "Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).",
+"type": "string"
+},
+"adsLabels": {
+"description": "Similar to ads_grouping, but only works on CPC.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"adsRedirect": {
+"description": "Allows advertisers to override the item URL when the product is shown within the context of Product ads.",
+"type": "string"
+},
+"adult": {
+"description": "Set to true if the item is targeted towards adults.",
+"type": "boolean"
+},
+"ageGroup": {
+"description": "Target [age group](https://support.google.com/merchants/answer/6324463) of the item.",
+"enum": [
+"AGE_GROUP_UNSPECIFIED",
+"ADULT",
+"KIDS",
+"TODDLER",
+"INFANT",
+"NEWBORN"
+],
+"enumDescriptions": [
+"Age group is not specified.",
+"Teens or older.",
+"5-13 years old.",
+"1-5 years old.",
+"3-12 months old.",
+"0-3 months old."
+],
+"type": "string"
+},
+"autoPricingMinPrice": {
+"$ref": "Price",
+"description": "A safeguard in the [automated discounts] (https://support.google.com/merchants/answer/10295759) and \"Dynamic Promotions\" (https://support.google.com/merchants/answer/13949249) projects, ensuring that discounts on business offers do not fall below this value, thereby preserving the offer's value and profitability."
+},
+"availability": {
+"description": "[Availability](https://support.google.com/merchants/answer/6324448) status of the item.",
+"enum": [
+"AVAILABILITY_UNSPECIFIED",
+"IN_STOCK",
+"OUT_OF_STOCK",
+"PREORDER",
+"LIMITED_AVAILABILITY",
+"BACKORDER"
+],
+"enumDescriptions": [
+"Availability is not specified.",
+"In stock.",
+"Out of stock.",
+"Pre-order.",
+"Limited availability.",
+"Backorder."
+],
+"type": "string"
+},
+"availabilityDate": {
+"description": "The day a pre-ordered product becomes available for delivery, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.",
+"format": "google-datetime",
+"type": "string"
+},
+"brand": {
+"description": "[Brand](https://support.google.com/merchants/answer/6324351) of the item. For example, \"Google\".",
+"type": "string"
+},
+"canonicalLink": {
+"description": "URL for the canonical version of your item's landing page.",
+"type": "string"
+},
+"certifications": {
+"description": "Product Certifications, for example for energy efficiency labeling of products recorded in the [EU EPREL](https://eprel.ec.europa.eu/screen/home) database. See the [Help Center](https://support.google.com/merchants/answer/13528839) article for more information.",
+"items": {
+"$ref": "ProductCertification"
+},
+"type": "array"
+},
+"cloudExportAdditionalProperties": {
+"description": "Extra fields to export to the Cloud Retail program.",
+"items": {
+"$ref": "CloudExportAdditionalProperties"
+},
+"type": "array"
+},
+"color": {
+"description": "[Color](https://support.google.com/merchants/answer/6324487) of the item. For example, \"red\".",
+"type": "string"
+},
+"condition": {
+"description": "[Condition](https://support.google.com/merchants/answer/6324469) or state of the item.",
+"enum": [
+"CONDITION_UNSPECIFIED",
+"NEW",
+"USED",
+"REFURBISHED"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Brand new, original, unopened packaging.",
+"Previously used, original packaging opened or missing.",
+"Professionally restored to working order, comes with a warranty, may or may not have the original packaging."
+],
+"type": "string"
+},
+"costOfGoodsSold": {
+"$ref": "Price",
+"description": "Cost of goods sold. Used for gross profit reporting."
+},
+"customLabel0": {
+"description": "[Custom label 0](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.",
+"type": "string"
+},
+"customLabel1": {
+"description": "[Custom label 1](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.",
+"type": "string"
+},
+"customLabel2": {
+"description": "[Custom label 2](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.",
+"type": "string"
+},
+"customLabel3": {
+"description": "[Custom label 3](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.",
+"type": "string"
+},
+"customLabel4": {
+"description": "[Custom label 4](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.",
+"type": "string"
+},
+"description": {
+"description": "Description of the item.",
+"type": "string"
+},
+"disclosureDate": {
+"description": "The date time when an offer becomes visible in search results across Google\u2019s YouTube surfaces, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. See [Disclosure date](https://support.google.com/merchants/answer/13034208) for more information.",
+"format": "google-datetime",
+"type": "string"
+},
+"displayAdsId": {
+"description": "An identifier for an item for dynamic remarketing campaigns.",
+"type": "string"
+},
+"displayAdsLink": {
+"description": "URL directly to your item's landing page for dynamic remarketing campaigns.",
+"type": "string"
+},
+"displayAdsSimilarIds": {
+"description": "Advertiser-specified recommendations. For more information, see [Display ads attribute specification](https://support.google.com/merchants/answer/6069387).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"displayAdsTitle": {
+"description": "Title of an item for dynamic remarketing campaigns.",
+"type": "string"
+},
+"displayAdsValue": {
+"description": "Offer margin for dynamic remarketing campaigns. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).",
+"format": "double",
+"type": "number"
+},
+"energyEfficiencyClass": {
+"description": "The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.",
+"enum": [
+"ENERGY_EFFICIENCY_CLASS_UNSPECIFIED",
+"APPP",
+"APP",
+"AP",
+"A",
+"B",
+"C",
+"D",
+"E",
+"F",
+"G"
+],
+"enumDescriptions": [
+"The energy efficiency class is unspecified.",
+"A+++.",
+"A++.",
+"A+.",
+"A.",
+"B.",
+"C.",
+"D.",
+"E.",
+"F.",
+"G."
+],
+"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.",
+"items": {
+"enum": [
+"DESTINATION_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"YOUTUBE_SHOPPING",
+"YOUTUBE_SHOPPING_CHECKOUT",
+"YOUTUBE_AFFILIATE",
+"FREE_VEHICLE_LISTINGS",
+"VEHICLE_ADS",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL"
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/google-ads/answer/2454022).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3057972).",
+"[Free listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/12362804).",
+"Youtube shopping checkout.",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[Free vehicle listings](https://support.google.com/merchants/answer/11189169).",
+"[Vehicle ads](https://support.google.com/merchants/answer/11189169).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail)."
+],
+"type": "string"
+},
+"type": "array"
+},
+"expirationDate": {
+"description": "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.",
+"format": "google-datetime",
+"type": "string"
+},
+"externalSellerId": {
+"description": "Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account.",
+"type": "string"
+},
+"freeShippingThreshold": {
+"description": "Conditions to be met for a product to have free shipping.",
+"items": {
+"$ref": "FreeShippingThreshold"
+},
+"type": "array"
+},
+"gender": {
+"description": "Target [gender](https://support.google.com/merchants/answer/6324479) of the item.",
+"enum": [
+"GENDER_UNSPECIFIED",
+"MALE",
+"FEMALE",
+"UNISEX"
+],
+"enumDescriptions": [
+"Gender is not specified.",
+"Male.",
+"Female.",
+"Unisex."
+],
+"type": "string"
+},
+"googleProductCategory": {
+"description": "Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.",
+"type": "string"
+},
+"gtins": {
+"description": "Global Trade Item Numbers ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item. You can provide up to 10 GTINs.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"identifierExists": {
+"description": "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.",
+"type": "boolean"
+},
+"imageLink": {
+"description": "URL of an image of the item.",
+"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.",
+"items": {
+"enum": [
+"DESTINATION_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"YOUTUBE_SHOPPING",
+"YOUTUBE_SHOPPING_CHECKOUT",
+"YOUTUBE_AFFILIATE",
+"FREE_VEHICLE_LISTINGS",
+"VEHICLE_ADS",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL"
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/google-ads/answer/2454022).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3057972).",
+"[Free listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/12362804).",
+"Youtube shopping checkout.",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[Free vehicle listings](https://support.google.com/merchants/answer/11189169).",
+"[Vehicle ads](https://support.google.com/merchants/answer/11189169).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail)."
+],
+"type": "string"
+},
+"type": "array"
+},
+"installment": {
+"$ref": "ProductInstallment",
+"description": "Number and amount of installments to pay for an item."
+},
+"isBundle": {
+"description": "Whether the item is a business-defined sub-API. A [sub-API] (https://support.google.com/merchants/answer/6324449) is a custom grouping of different products sold by a business for a single price.",
+"type": "boolean"
+},
+"itemGroupId": {
+"description": "Shared identifier for all variants of the same product.",
+"type": "string"
+},
+"lifestyleImageLinks": {
+"description": "Additional URLs of lifestyle images of the item, used to explicitly identify images that showcase your item in a real-world context. See the [Help Center article](https://support.google.com/merchants/answer/9103186) for more information.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"link": {
+"description": "URL directly linking to your item's page on your online store.",
+"type": "string"
+},
+"linkTemplate": {
+"description": "[Link template](https://support.google.com/merchants/answer/13871172) for business hosted local storefront.",
+"type": "string"
+},
+"loyaltyPoints": {
+"$ref": "LoyaltyPoints",
+"description": "Loyalty points that users receive after purchasing the item. Japan only."
+},
+"loyaltyPrograms": {
+"description": "A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item.",
+"items": {
+"$ref": "LoyaltyProgram"
+},
+"type": "array"
+},
+"material": {
+"description": "The [material](https://support.google.com/merchants/answer/6324410) of which the item is made. For example, \"Leather\" or \"Cotton\".",
+"type": "string"
+},
+"maxEnergyEfficiencyClass": {
+"description": "The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.",
+"enum": [
+"ENERGY_EFFICIENCY_CLASS_UNSPECIFIED",
+"APPP",
+"APP",
+"AP",
+"A",
+"B",
+"C",
+"D",
+"E",
+"F",
+"G"
+],
+"enumDescriptions": [
+"The energy efficiency class is unspecified.",
+"A+++.",
+"A++.",
+"A+.",
+"A.",
+"B.",
+"C.",
+"D.",
+"E.",
+"F.",
+"G."
+],
+"type": "string"
+},
+"maxHandlingTime": {
+"description": "Maximal product handling time (in business days).",
+"format": "int64",
+"type": "string"
+},
+"maximumRetailPrice": {
+"$ref": "Price",
+"description": "Maximum retail price (MRP) of the item. Applicable to India only."
+},
+"minEnergyEfficiencyClass": {
+"description": "The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.",
+"enum": [
+"ENERGY_EFFICIENCY_CLASS_UNSPECIFIED",
+"APPP",
+"APP",
+"AP",
+"A",
+"B",
+"C",
+"D",
+"E",
+"F",
+"G"
+],
+"enumDescriptions": [
+"The energy efficiency class is unspecified.",
+"A+++.",
+"A++.",
+"A+.",
+"A.",
+"B.",
+"C.",
+"D.",
+"E.",
+"F.",
+"G."
+],
+"type": "string"
+},
+"minHandlingTime": {
+"description": "Minimal product handling time (in business days).",
+"format": "int64",
+"type": "string"
+},
+"mobileLink": {
+"description": "URL for the mobile-optimized version of your item's landing page.",
+"type": "string"
+},
+"mobileLinkTemplate": {
+"description": "[Link template](https://support.google.com/merchants/answer/13870216) for business hosted local storefront optimized for mobile devices.",
+"type": "string"
+},
+"mpn": {
+"description": "Manufacturer Part Number ([MPN](https://support.google.com/merchants/answer/188494#mpn)) of the item.",
+"type": "string"
+},
+"multipack": {
+"description": "The number of identical products in a business-defined multipack.",
+"format": "int64",
+"type": "string"
+},
+"pattern": {
+"description": "The item's [pattern](https://support.google.com/merchants/answer/6324483). For example, polka dots.",
+"type": "string"
+},
+"pause": {
+"description": "Publication of this item will be temporarily [paused](https://support.google.com/merchants/answer/11909930).",
+"enum": [
+"PAUSE_UNSPECIFIED",
+"ADS",
+"ALL"
+],
+"enumDescriptions": [
+"The pause is unspecified.",
+"You\u2019re currently pausing your product for all ads locations (including Shopping Ads, Display Ads, and local inventory ads).",
+"You\u2019re currently pausing your product for all Shopping locations (including Shopping Ads, Display Ads, local inventory ads, Buy on Google, and free listings)."
+],
+"type": "string"
+},
+"pickupMethod": {
+"description": "The [pickup](https://support.google.com/merchants/answer/14634021) option for the item.",
+"enum": [
+"PICKUP_METHOD_UNSPECIFIED",
+"NOT_SUPPORTED",
+"BUY",
+"RESERVE",
+"SHIP_TO_STORE"
+],
+"enumDescriptions": [
+"Pickup method is not specified.",
+"The item is not available for store pickup.",
+"The entire transaction occurs online.",
+"The item is reserved online and the transaction occurs in-store.",
+"The item is purchased online and shipped to a local store for the customer to pick up."
+],
+"type": "string"
+},
+"pickupSla": {
+"description": "Item store pickup timeline. For more information, see [Pickup SLA](https://support.google.com/merchants/answer/14635400).",
+"enum": [
+"PICKUP_SLA_UNSPECIFIED",
+"SAME_DAY",
+"NEXT_DAY",
+"TWO_DAY",
+"THREE_DAY",
+"FOUR_DAY",
+"FIVE_DAY",
+"SIX_DAY",
+"MULTI_WEEK"
+],
+"enumDescriptions": [
+"Pickup SLA is not specified.",
+"Indicates that the product is available for pickup the same day that the order is placed, subject to cut off times.",
+"Indicates that the product is available for pickup the following day that the order is placed.",
+"Indicates that the product will be shipped to a store for a customer to pick up in 2 days.",
+"Indicates that the product will be shipped to a store for a customer to pick up in 3 days.",
+"Indicates that the product will be shipped to a store for a customer to pick up in 4 days",
+"Indicates that the product will be shipped to a store for a customer to pick up in 5 days.",
+"Indicates that the product will be shipped to a store for a customer to pick up in 6 days.",
+"Indicates that the product will be shipped to a store for a customer to pick up in one week or more."
+],
+"type": "string"
+},
+"price": {
+"$ref": "Price",
+"description": "Price of the item."
+},
+"productDetails": {
+"description": "Technical specification or additional product details.",
+"items": {
+"$ref": "ProductDetail"
+},
+"type": "array"
+},
+"productHeight": {
+"$ref": "ProductDimension",
+"description": "The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive)."
+},
+"productHighlights": {
+"description": "Bullet points describing the most relevant [product highlights](https://support.google.com/merchants/answer/9216100).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"productLength": {
+"$ref": "ProductDimension",
+"description": "The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive)."
+},
+"productTypes": {
+"description": "Categories of the item (formatted as in [product data specification](https://support.google.com/merchants/answer/7052112#product_category)).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"productWeight": {
+"$ref": "ProductWeight",
+"description": "The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive)."
+},
+"productWidth": {
+"$ref": "ProductDimension",
+"description": "The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive)."
+},
+"promotionIds": {
+"description": "The unique ID of a promotion.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"salePrice": {
+"$ref": "Price",
+"description": "Advertised sale price of the item."
+},
+"salePriceEffectiveDate": {
+"$ref": "Interval",
+"description": "Date range during which the item is on sale, see [product data specification](https://support.google.com/merchants/answer/7052112#price_and_availability)."
+},
+"sellOnGoogleQuantity": {
+"description": "The quantity of the product that is available for selling on Google. Supported only for online products.",
+"format": "int64",
+"type": "string"
+},
+"shipping": {
+"description": "Shipping rules.",
+"items": {
+"$ref": "Shipping"
+},
+"type": "array"
+},
+"shippingHeight": {
+"$ref": "ShippingDimension",
+"description": "Height of the item for shipping."
+},
+"shippingLabel": {
+"description": "The shipping label of the product, used to group product in account-level shipping rules.",
+"type": "string"
+},
+"shippingLength": {
+"$ref": "ShippingDimension",
+"description": "Length of the item for shipping."
+},
+"shippingWeight": {
+"$ref": "ShippingWeight",
+"description": "Weight of the item for shipping."
+},
+"shippingWidth": {
+"$ref": "ShippingDimension",
+"description": "Width of the item for shipping."
+},
+"shoppingAdsExcludedCountries": {
+"description": "List of country codes [(ISO 3166-1 alpha-2)](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in data source settings.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"size": {
+"description": "Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same `itemGroupId` value, see [Size](https://support.google.com/merchants/answer/6324492).",
+"type": "string"
+},
+"sizeSystem": {
+"description": "System in which the size is specified. Recommended for apparel items. For more information, see [Size system](https://support.google.com/merchants/answer/6324502).",
+"enum": [
+"SIZE_SYSTEM_UNSPECIFIED",
+"AU",
+"BR",
+"CN",
+"DE",
+"EU",
+"FR",
+"IT",
+"JP",
+"MEX",
+"UK",
+"US"
+],
+"enumDescriptions": [
+"Unspecified size system.",
+"AU.",
+"BR.",
+"CN.",
+"DE.",
+"EU.",
+"FR.",
+"IT.",
+"JP.",
+"MEX.",
+"UK.",
+"US."
+],
+"type": "string"
+},
+"sizeTypes": {
+"description": "The cut of the item. It can be used to represent combined size types for apparel items. Maximum two of size types can be provided, see [Size type](https://support.google.com/merchants/answer/6324497).",
+"items": {
+"enum": [
+"SIZE_TYPE_UNSPECIFIED",
+"REGULAR",
+"PETITE",
+"MATERNITY",
+"BIG",
+"TALL",
+"PLUS"
+],
+"enumDescriptions": [
+"The size type is not specified.",
+"Regular size.",
+"Petite size.",
+"Maternity size.",
+"Big size.",
+"Tall size.",
+"Plus size."
+],
+"type": "string"
+},
+"type": "array"
+},
+"structuredDescription": {
+"$ref": "StructuredDescription",
+"description": "Structured description, for algorithmically (AI)-generated descriptions."
+},
+"structuredTitle": {
+"$ref": "StructuredTitle",
+"description": "Structured title, for algorithmically (AI)-generated titles."
+},
+"subscriptionCost": {
+"$ref": "SubscriptionCost",
+"description": "Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract."
+},
+"sustainabilityIncentives": {
+"description": "The list of sustainability incentive programs.",
+"items": {
+"$ref": "ProductSustainabilityIncentive"
+},
+"type": "array"
+},
+"title": {
+"description": "Title of the item.",
+"type": "string"
+},
+"transitTimeLabel": {
+"description": "The transit time label of the product, used to group product in account-level transit time tables.",
+"type": "string"
+},
+"unitPricingBaseMeasure": {
+"$ref": "UnitPricingBaseMeasure",
+"description": "The preference of the denominator of the unit price."
+},
+"unitPricingMeasure": {
+"$ref": "UnitPricingMeasure",
+"description": "The measure and dimension of an item."
+},
+"virtualModelLink": {
+"description": "URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductCertification": {
+"description": "Product [certification](https://support.google.com/merchants/answer/13528839), initially introduced for EU energy efficiency labeling compliance using the EU EPREL database.",
+"id": "ProductCertification",
+"properties": {
+"certificationAuthority": {
+"description": "The certification authority.",
+"enum": [
+"CERTIFICATION_AUTHORITY_UNSPECIFIED",
+"ADEME",
+"BMWK",
+"EPA",
+"EC"
+],
+"enumDescriptions": [
+"Certification authority is not specified.",
+"For the French CO2 emissions class for vehicles.",
+"For the German CO2 emissions classes for vehicles.",
+"Environment Protection Agency.",
+"European Commission for energy labels in the EU."
+],
+"type": "string"
+},
+"certificationCode": {
+"description": "The certification code. Maximum length is 2000 characters.",
+"type": "string"
+},
+"certificationName": {
+"description": "The name of the certification.",
+"enum": [
+"CERTIFICATION_NAME_UNSPECIFIED",
+"ENERGY_STAR",
+"ENERGY_STAR_MOST_EFFICIENT",
+"EPREL",
+"EU_ECOLABEL",
+"VEHICLE_ENERGY_EFFICIENCY",
+"VEHICLE_ENERGY_EFFICIENCY_DISCHARGED_BATTERY"
+],
+"enumDescriptions": [
+"Certification name is not specified.",
+"Energy Star.",
+"Energy Star Most Efficient.",
+"Represents energy efficiency certifications in the EU European Registry for Energy Labeling (EPREL) database.",
+"EU Ecolabel.",
+"The overall CO2 class of a vehicle",
+"For the CO2 class of a vehicle with a discharged battery."
+],
+"type": "string"
+},
+"certificationValue": {
+"description": "The certification value (also known as class, level or grade), for example \"A+\", \"C\", \"gold\". Maximum length is 2000 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductChange": {
+"description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.",
+"id": "ProductChange",
+"properties": {
+"newValue": {
+"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"oldValue": {
+"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"regionCode": {
+"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
+"type": "string"
+},
+"reportingContext": {
+"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductDetail": {
+"description": "The product details.",
+"id": "ProductDetail",
+"properties": {
+"attributeName": {
+"description": "The name of the product detail.",
+"type": "string"
+},
+"attributeValue": {
+"description": "The value of the product detail.",
+"type": "string"
+},
+"sectionName": {
+"description": "The section header used to group a set of product details.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductDimension": {
+"description": "The dimension of the product.",
+"id": "ProductDimension",
+"properties": {
+"unit": {
+"description": "Required. The dimension units. Acceptable values are: * \"`in`\" * \"`cm`\"",
+"type": "string"
+},
+"value": {
+"description": "Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"ProductInput": {
+"description": "This resource represents input data you submit for a product, not the processed product that you see in Merchant Center, in Shopping ads, or across Google surfaces. Product inputs, rules and supplemental data source data are combined to create the processed Product. For more information, see [Manage products](/merchant/api/guides/products/overview). Required product input attributes to pass data validation checks are primarily defined in the [Products Data Specification](https://support.google.com/merchants/answer/188494). The following attributes are required: feedLabel, contentLanguage and offerId. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved. All fields in the product input and its sub-messages match the English name of their corresponding attribute in the [Products Data Specification](https://support.google.com/merchants/answer/188494) with [some exceptions](https://support.google.com/merchants/answer/7052112). The following reference documentation lists the field names in the **camelCase** casing style while the Products Data Specification lists the names in the **snake_case** casing style.",
+"id": "ProductInput",
+"properties": {
+"contentLanguage": {
+"description": "Required. Immutable. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the product.",
+"type": "string"
+},
+"customAttributes": {
+"description": "Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ \"name\": \"size type\", \"value\": \"regular\" }`). This is useful for submitting attributes not explicitly exposed by the API. Maximum allowed number of characters for each custom attribute is 10240 (represents sum of characters for name and value). Maximum 2500 custom attributes can be set per product, with total size of 102.4kB. Underscores in custom attribute names are replaced by spaces upon insertion.",
+"items": {
+"$ref": "CustomAttribute"
+},
+"type": "array"
+},
+"feedLabel": {
+"description": "Required. Immutable. The feed label that lets you categorize and identify your products. The maximum allowed characters are 20, and the supported characters are `A-Z`, `0-9`, hyphen, and underscore. The feed label must not include any spaces. For more information, see [Using feed labels](//support.google.com/merchants/answer/14994087).",
+"type": "string"
+},
+"legacyLocal": {
+"description": "Immutable. Determines whether the product is **only** targeting local destinations and whether the product name should be distinguished with a `local~` prefix. For example, `accounts/123/productInputs/local~en~US~sku123`. If a product that is not `legacy_local` is already targeting local destinations, creating a `legacy_local` product with an otherwise matching name will fail.",
+"type": "boolean"
+},
+"name": {
+"description": "Identifier. The name of the product input. Format: `accounts/{account}/productInputs/{productinput}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.",
+"type": "string"
+},
+"offerId": {
+"description": "Required. Immutable. Your unique identifier for the product. This is the same for the product input and processed product. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. See the [products data specification](https://support.google.com/merchants/answer/188494#id) for details.",
+"type": "string"
+},
+"product": {
+"description": "Output only. The name of the processed product. Format: `accounts/{account}/products/{product}`",
+"readOnly": true,
+"type": "string"
+},
+"productAttributes": {
+"$ref": "ProductAttributes",
+"description": "Optional. A list of strongly-typed product attributes."
+},
+"versionNumber": {
+"description": "Optional. Immutable. Represents the existing version (freshness) of the product, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing product. Re-insertion (for example, product refresh after 30 days) can be performed with the current `version_number`. Only supported for insertions into primary data sources. Do not set this field for updates. Do not set this field for insertions into supplemental data sources. If the operation is prevented, the aborted exception will be thrown.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductInstallment": {
+"description": "A message that represents installment.",
+"id": "ProductInstallment",
+"properties": {
+"amount": {
+"$ref": "Price",
+"description": "The amount the buyer has to pay per month."
+},
+"creditType": {
+"description": "Type of installment payments.",
+"enum": [
+"CREDIT_TYPE_UNSPECIFIED",
+"FINANCE",
+"LEASE"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Finance.",
+"Lease."
+],
+"type": "string"
+},
+"downpayment": {
+"$ref": "Price",
+"description": "The up-front down payment amount the buyer has to pay."
+},
+"months": {
+"description": "The number of installments the buyer has to pay.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductStatus": {
+"description": "The status of a product, data validation issues, that is, information about a product computed asynchronously.",
+"id": "ProductStatus",
+"properties": {
+"creationDate": {
+"description": "Date on which the item has been created, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.",
+"format": "google-datetime",
+"type": "string"
+},
+"destinationStatuses": {
+"description": "The intended destinations for the product.",
+"items": {
+"$ref": "DestinationStatus"
+},
+"type": "array"
+},
+"googleExpirationDate": {
+"description": "Date on which the item expires, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.",
+"format": "google-datetime",
+"type": "string"
+},
+"itemLevelIssues": {
+"description": "A list of all issues associated with the product.",
+"items": {
+"$ref": "ItemLevelIssue"
+},
+"type": "array"
+},
+"lastUpdateDate": {
+"description": "Date on which the item has been last updated, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductStatusChangeMessage": {
+"description": "The message that the merchant will receive to notify about product status change event",
+"id": "ProductStatusChangeMessage",
+"properties": {
+"account": {
+"description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`",
+"type": "string"
+},
+"attribute": {
+"description": "The attribute in the resource that changed, in this case it will be always `Status`.",
+"enum": [
+"ATTRIBUTE_UNSPECIFIED",
+"STATUS"
+],
+"enumDescriptions": [
+"Unspecified attribute",
+"Status of the changed entity"
+],
+"type": "string"
+},
+"changes": {
+"description": "A message to describe the change that happened to the product",
+"items": {
+"$ref": "ProductChange"
+},
+"type": "array"
+},
+"eventTime": {
+"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationTime": {
+"description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.",
+"format": "google-datetime",
+"type": "string"
+},
+"managingAccount": {
+"description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`",
+"type": "string"
+},
+"resource": {
+"description": "The product name. Format: `accounts/{account}/products/{product}`",
+"type": "string"
+},
+"resourceId": {
+"description": "The product id.",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource that changed, in this case it will always be `Product`.",
+"enum": [
+"RESOURCE_UNSPECIFIED",
+"PRODUCT"
+],
+"enumDescriptions": [
+"Unspecified resource",
+"Resource type : product"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductSustainabilityIncentive": {
+"description": "Information regarding sustainability-related incentive programs such as rebates or tax relief.",
+"id": "ProductSustainabilityIncentive",
+"properties": {
+"amount": {
+"$ref": "Price",
+"description": "The fixed amount of the incentive."
+},
+"percentage": {
+"description": "The percentage of the sale price that the incentive is applied to.",
+"format": "double",
+"type": "number"
+},
+"type": {
+"description": "Sustainability incentive program.",
+"enum": [
+"TYPE_UNSPECIFIED",
+"EV_TAX_CREDIT",
+"EV_PRICE_DISCOUNT"
+],
+"enumDescriptions": [
+"Unspecified or unknown sustainability incentive type.",
+"Program offering tax liability reductions for electric vehicles and, in some countries, plug-in hybrids. These reductions can be based on a specific amount or a percentage of the sale price.",
+"A subsidy program, often called an environmental bonus, provides a purchase grant for electric vehicles and, in some countries, plug-in hybrids. The grant amount may be a fixed sum or a percentage of the sale price."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductWeight": {
+"description": "The weight of the product.",
+"id": "ProductWeight",
+"properties": {
+"unit": {
+"description": "Required. The weight unit. Acceptable values are: * \"`g`\" * \"`kg`\" * \"`oz`\" * \"`lb`\"",
+"type": "string"
+},
+"value": {
+"description": "Required. The weight represented as a number. The weight can have a maximum precision of four decimal places.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"Shipping": {
+"description": "The Shipping of the product.",
+"id": "Shipping",
+"properties": {
+"country": {
+"description": "The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.",
+"type": "string"
+},
+"locationGroupName": {
+"description": "The location where the shipping is applicable, represented by a location group name.",
+"type": "string"
+},
+"locationId": {
+"description": "The numeric ID of a location that the shipping rate applies to as defined in the [AdWords API](https://developers.google.com/adwords/api/docs/appendix/geotargeting).",
+"format": "int64",
+"type": "string"
+},
+"maxHandlingTime": {
+"description": "Maximum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minHandlingTime is optional if maxHandlingTime is present.",
+"format": "int64",
+"type": "string"
+},
+"maxTransitTime": {
+"description": "Maximum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minTransitTime is optional if maxTransitTime is present.",
+"format": "int64",
+"type": "string"
+},
+"minHandlingTime": {
+"description": "Minimum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. minHandlingTime can only be present together with maxHandlingTime; but it is not required if maxHandlingTime is present.",
+"format": "int64",
+"type": "string"
+},
+"minTransitTime": {
+"description": "Minimum transit time (inclusive) between when the order has shipped and when it is delivered in business days. 0 means that the order is delivered on the same day as it ships. minTransitTime can only be present together with maxTransitTime; but it is not required if maxTransitTime is present.",
+"format": "int64",
+"type": "string"
+},
+"postalCode": {
+"description": "The postal code range that the shipping rate applies to, represented by a postal code, a postal code prefix followed by a * wildcard, a range between two postal codes or two postal code prefixes of equal length.",
+"type": "string"
+},
+"price": {
+"$ref": "Price",
+"description": "Fixed shipping price, represented as a number."
+},
+"region": {
+"description": "The geographic region to which a shipping rate applies. See [region](https://support.google.com/merchants/answer/6324484) for more information.",
+"type": "string"
+},
+"service": {
+"description": "A free-form description of the service class or delivery speed.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ShippingDimension": {
+"description": "The ShippingDimension of the product.",
+"id": "ShippingDimension",
+"properties": {
+"unit": {
+"description": "The unit of value.",
+"type": "string"
+},
+"value": {
+"description": "The dimension of the product used to calculate the shipping cost of the item.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"ShippingWeight": {
+"description": "The ShippingWeight of the product.",
+"id": "ShippingWeight",
+"properties": {
+"unit": {
+"description": "The unit of value.",
+"type": "string"
+},
+"value": {
+"description": "The weight of the product used to calculate the shipping cost of the item.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"StructuredDescription": {
+"description": "Structured description, for algorithmically (AI)-generated descriptions.",
+"id": "StructuredDescription",
+"properties": {
+"content": {
+"description": "The description text Maximum length is 5000 characters",
+"type": "string"
+},
+"digitalSourceType": {
+"description": "The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).",
+"enum": [
+"DIGITAL_SOURCE_TYPE_UNSPECIFIED",
+"TRAINED_ALGORITHMIC_MEDIA",
+"DEFAULT"
+],
+"enumDescriptions": [
+"Digital source type is unspecified.",
+"Text created algorithmically using a model derived from sampled content.",
+"Text NOT created algorithmically using a model derived from sampled content (the default)"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"StructuredTitle": {
+"description": "Structured title, for algorithmically (AI)-generated titles.",
+"id": "StructuredTitle",
+"properties": {
+"content": {
+"description": "The title text Maximum length is 150 characters",
+"type": "string"
+},
+"digitalSourceType": {
+"description": "The digital source type. Following [IPTC](https://cv.iptc.org/newscodes/digitalsourcetype).",
+"enum": [
+"DIGITAL_SOURCE_TYPE_UNSPECIFIED",
+"TRAINED_ALGORITHMIC_MEDIA",
+"DEFAULT"
+],
+"enumDescriptions": [
+"Digital source type is unspecified.",
+"Text created algorithmically using a model derived from sampled content.",
+"Text NOT created algorithmically using a model derived from sampled content (the default)"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"SubscriptionCost": {
+"description": "The SubscriptionCost of the product.",
+"id": "SubscriptionCost",
+"properties": {
+"amount": {
+"$ref": "Price",
+"description": "The amount the buyer has to pay per subscription period."
+},
+"period": {
+"description": "The type of subscription period. Supported values are: * \"`month`\" * \"`year`\"",
+"enum": [
+"SUBSCRIPTION_PERIOD_UNSPECIFIED",
+"MONTH",
+"YEAR"
+],
+"enumDescriptions": [
+"Indicates that the subscription period is unspecified.",
+"Indicates that the subscription period is month.",
+"Indicates that the subscription period is year."
+],
+"type": "string"
+},
+"periodLength": {
+"description": "The number of subscription periods the buyer has to pay.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"UnitPricingBaseMeasure": {
+"description": "The UnitPricingBaseMeasure of the product.",
+"id": "UnitPricingBaseMeasure",
+"properties": {
+"unit": {
+"description": "The unit of the denominator.",
+"type": "string"
+},
+"value": {
+"description": "The denominator of the unit price.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"UnitPricingMeasure": {
+"description": "The UnitPricingMeasure of the product.",
+"id": "UnitPricingMeasure",
+"properties": {
+"unit": {
+"description": "The unit of the measure.",
+"type": "string"
+},
+"value": {
+"description": "The measure of an item.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+}
+},
+"servicePath": "",
+"title": "Merchant API",
+"version": "products_v1",
+"version_module": true
+}
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.promotions_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.promotions_v1.json
new file mode 100644
index 00000000000..f06d39a393b
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/merchantapi.promotions_v1.json
@@ -0,0 +1,1034 @@
+{
+"auth": {
+"oauth2": {
+"scopes": {
+"https://www.googleapis.com/auth/content": {
+"description": "Manage your product listings and accounts for Google Shopping"
+}
+}
+}
+},
+"basePath": "",
+"baseUrl": "https://merchantapi.googleapis.com/",
+"batchPath": "batch",
+"canonicalName": "Merchant",
+"description": "Programmatically manage your Merchant Center Accounts.",
+"discoveryVersion": "v1",
+"documentationLink": "https://developers.google.com/merchant/api",
+"fullyEncodeReservedExpansion": true,
+"icons": {
+"x16": "http://www.google.com/images/icons/product/search-16.gif",
+"x32": "http://www.google.com/images/icons/product/search-32.gif"
+},
+"id": "merchantapi:promotions_v1",
+"kind": "discovery#restDescription",
+"mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/",
+"name": "merchantapi",
+"ownerDomain": "google.com",
+"ownerName": "Google",
+"parameters": {
+"$.xgafv": {
+"description": "V1 error format.",
+"enum": [
+"1",
+"2"
+],
+"enumDescriptions": [
+"v1 error format",
+"v2 error format"
+],
+"location": "query",
+"type": "string"
+},
+"access_token": {
+"description": "OAuth access token.",
+"location": "query",
+"type": "string"
+},
+"alt": {
+"default": "json",
+"description": "Data format for response.",
+"enum": [
+"json",
+"media",
+"proto"
+],
+"enumDescriptions": [
+"Responses with Content-Type of application/json",
+"Media download with context-dependent Content-Type",
+"Responses with Content-Type of application/x-protobuf"
+],
+"location": "query",
+"type": "string"
+},
+"callback": {
+"description": "JSONP",
+"location": "query",
+"type": "string"
+},
+"fields": {
+"description": "Selector specifying which fields to include in a partial response.",
+"location": "query",
+"type": "string"
+},
+"key": {
+"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+"location": "query",
+"type": "string"
+},
+"oauth_token": {
+"description": "OAuth 2.0 token for the current user.",
+"location": "query",
+"type": "string"
+},
+"prettyPrint": {
+"default": "true",
+"description": "Returns response with indentations and line breaks.",
+"location": "query",
+"type": "boolean"
+},
+"quotaUser": {
+"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+"location": "query",
+"type": "string"
+},
+"uploadType": {
+"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+"location": "query",
+"type": "string"
+},
+"upload_protocol": {
+"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+"location": "query",
+"type": "string"
+}
+},
+"protocol": "rest",
+"resources": {
+"accounts": {
+"resources": {
+"promotions": {
+"methods": {
+"get": {
+"description": "Retrieves the promotion from your Merchant Center account. After inserting or updating a promotion input, it may take several minutes before the updated promotion can be retrieved.",
+"flatPath": "promotions/v1/accounts/{accountsId}/promotions/{promotionsId}",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.promotions.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the promotion to retrieve. Format: `accounts/{account}/promotions/{promotions}`",
+"location": "path",
+"pattern": "^accounts/[^/]+/promotions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "promotions/v1/{+name}",
+"response": {
+"$ref": "Promotion"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"insert": {
+"description": "Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead.",
+"flatPath": "promotions/v1/accounts/{accountsId}/promotions:insert",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.promotions.insert",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The account where the promotion will be inserted. Format: accounts/{account}",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "promotions/v1/{+parent}/promotions:insert",
+"request": {
+"$ref": "InsertPromotionRequest"
+},
+"response": {
+"$ref": "Promotion"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
+"list": {
+"description": "Lists the promotions in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested. After inserting or updating a promotion, it may take several minutes before the updated processed promotion can be retrieved.",
+"flatPath": "promotions/v1/accounts/{accountsId}/promotions",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.promotions.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of promotions to return. The service may return fewer than this value. The maximum value is 250; values above 250 will be coerced to 250. If unspecified, the maximum number of promotions will be returned.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListPromotions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPromotions` must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The account to list processed promotions for. Format: `accounts/{account}`",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "promotions/v1/{+parent}/promotions",
+"response": {
+"$ref": "ListPromotionsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+}
+},
+"revision": "20250805",
+"rootUrl": "https://merchantapi.googleapis.com/",
+"schemas": {
+"Attributes": {
+"description": "Attributes.",
+"id": "Attributes",
+"properties": {
+"brandExclusion": {
+"description": "Optional. Product filter by [brand exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"brandInclusion": {
+"description": "Optional. Product filter by brand for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"couponValueType": {
+"description": "Required. The [coupon value type] (https://support.google.com/merchants/answer/13861986?ref_topic=13773355&sjid=17642868584668136159-NC) attribute to signal the type of promotion that you are running. Depending on type of the selected coupon value [some attributes are required](https://support.google.com/merchants/answer/6393006?ref_topic=7322920).",
+"enum": [
+"COUPON_VALUE_TYPE_UNSPECIFIED",
+"MONEY_OFF",
+"PERCENT_OFF",
+"BUY_M_GET_N_MONEY_OFF",
+"BUY_M_GET_N_PERCENT_OFF",
+"BUY_M_GET_MONEY_OFF",
+"BUY_M_GET_PERCENT_OFF",
+"FREE_GIFT",
+"FREE_GIFT_WITH_VALUE",
+"FREE_GIFT_WITH_ITEM_ID",
+"FREE_SHIPPING_STANDARD",
+"FREE_SHIPPING_OVERNIGHT",
+"FREE_SHIPPING_TWO_DAY"
+],
+"enumDescriptions": [
+"Indicates that the coupon value type is unspecified.",
+"Money off coupon value type.",
+"Percent off coupon value type.",
+"Buy M quantity, get N money off coupon value type. `minimum_purchase_quantity` and `get_this_quantity_discounted` must be present. `money_off_amount` must also be present.",
+"Buy M quantity, get N percent off coupon value type. `minimum_purchase_quantity` and `get_this_quantity_discounted` must be present. `percent_off_percentage` must also be present.",
+"Buy M quantity, get money off. `minimum_purchase_quantity` and `money_off_amount` must be present.",
+"Buy M quantity, get money off. `minimum_purchase_quantity` and `percent_off_percentage` must be present.",
+"Free gift with description only.",
+"Free gift with monetary value.",
+"Free gift with item ID.",
+"Standard free shipping coupon value type. Only available for online promotions.",
+"Overnight free shipping coupon value type. Only available for online promotions.",
+"Two day free shipping coupon value type. Only available for online promotions."
+],
+"type": "string"
+},
+"freeGiftDescription": {
+"description": "Optional. [Free gift description](https://support.google.com/merchants/answer/13847245?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.",
+"type": "string"
+},
+"freeGiftItemId": {
+"description": "Optional. [Free gift item ID](https://support.google.com/merchants/answer/13857152?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.",
+"type": "string"
+},
+"freeGiftValue": {
+"$ref": "Price",
+"description": "Optional. [Free gift value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion."
+},
+"genericRedemptionCode": {
+"description": "Optional. Generic redemption code for the promotion. To be used with the `offerType` field and must meet the [minimum requirements](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC).",
+"type": "string"
+},
+"getThisQuantityDiscounted": {
+"description": "Optional. The number of items discounted in the promotion. The attribute is set when `couponValueType` is equal to `buy_m_get_n_money_off` or `buy_m_get_n_percent_off`.",
+"format": "int64",
+"type": "string"
+},
+"itemGroupIdExclusion": {
+"description": "Optional. Product filter by [item group ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC). The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC). exclusion for the promotion.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"itemGroupIdInclusion": {
+"description": "Optional. Product filter by item group ID for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability [product_applicability] attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"itemIdExclusion": {
+"description": "Optional. Product filter by [item ID exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"itemIdInclusion": {
+"description": "Optional. Product filter by [item ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"limitQuantity": {
+"description": "Optional. [Maximum purchase quantity](https://support.google.com/merchants/answer/13861564?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.",
+"format": "int64",
+"type": "string"
+},
+"limitValue": {
+"$ref": "Price",
+"description": "Optional. [Maximum product price](https://support.google.com/merchants/answer/2906014) for promotion."
+},
+"longTitle": {
+"description": "Required. [Long title](https://support.google.com/merchants/answer/13838102?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion.",
+"type": "string"
+},
+"minimumPurchaseAmount": {
+"$ref": "Price",
+"description": "Optional. [Minimum purchase amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion."
+},
+"minimumPurchaseQuantity": {
+"format": "int64",
+"type": "string"
+},
+"moneyOffAmount": {
+"$ref": "Price",
+"description": "Optional. The [money off amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC) offered in the promotion."
+},
+"offerType": {
+"description": "Required. [Type](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC) of the promotion. Use this attribute to indicate whether or not customers need a coupon code to redeem your promotion.",
+"enum": [
+"OFFER_TYPE_UNSPECIFIED",
+"NO_CODE",
+"GENERIC_CODE"
+],
+"enumDescriptions": [
+"Unknown offer type.",
+"Offer type without a code.",
+"Offer type with a code. Generic redemption code for the promotion is required when `offerType` = `GENERIC_CODE`."
+],
+"type": "string"
+},
+"percentOff": {
+"description": "Optional. The [percentage discount](https://support.google.com/merchants/answer/13837404?sjid=17642868584668136159-NC) offered in the promotion.",
+"format": "int64",
+"type": "string"
+},
+"productApplicability": {
+"description": "Required. Applicability of the promotion to either all products or [only specific products](https://support.google.com/merchants/answer/6396257?ref_topic=6396150&sjid=17642868584668136159-NC).",
+"enum": [
+"PRODUCT_APPLICABILITY_UNSPECIFIED",
+"ALL_PRODUCTS",
+"SPECIFIC_PRODUCTS"
+],
+"enumDescriptions": [
+"Which products the promotion applies to is unknown.",
+"Applicable to all products.",
+"Applicable to only a single product or list of products."
+],
+"type": "string"
+},
+"productTypeExclusion": {
+"description": "Optional. Product filter by [product type exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"productTypeInclusion": {
+"description": "Optional. Product filter by product type for the promotion. The product filter attributes only applies when the products eligible for promotion product applicability `product_applicability` attribute is set to [specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"promotionDestinations": {
+"description": "Required. The list of destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) where the promotion applies to. If you don't specify a destination by including a supported value in your data source, your promotion will display in Shopping ads and free listings by default. You may have previously submitted the following values as destinations for your products: Shopping Actions, Surfaces across Google, Local surfaces across Google. To represent these values use `FREE_LISTINGS`, `FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see [Promotion destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)",
+"items": {
+"enum": [
+"DESTINATION_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"YOUTUBE_SHOPPING",
+"YOUTUBE_SHOPPING_CHECKOUT",
+"YOUTUBE_AFFILIATE",
+"FREE_VEHICLE_LISTINGS",
+"VEHICLE_ADS",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL"
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/google-ads/answer/2454022).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3057972).",
+"[Free listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/12362804).",
+"Youtube shopping checkout.",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[Free vehicle listings](https://support.google.com/merchants/answer/11189169).",
+"[Vehicle ads](https://support.google.com/merchants/answer/11189169).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail)."
+],
+"type": "string"
+},
+"type": "array"
+},
+"promotionDisplayTimePeriod": {
+"$ref": "Interval",
+"description": "Optional. `TimePeriod` representation of the promotion's display dates. This attribute specifies the date and time frame when the promotion will be live on Google.com and Shopping ads. If the display time period for promotion `promotion_display_time_period` attribute is not specified, the promotion effective time period `promotion_effective_time_period` determines the date and time frame when the promotion will be live on Google.com and Shopping ads."
+},
+"promotionEffectiveTimePeriod": {
+"$ref": "Interval",
+"description": "Required. `TimePeriod` representation of the promotion's effective dates. This attribute specifies that the promotion can be tested on your online store during this time period."
+},
+"promotionUrl": {
+"description": "Optional. URL to the page on the merchant's site where the promotion shows. Local Inventory ads promotions throw an error if no `promotion_url` is included. URL is used to confirm that the promotion is valid and can be redeemed.",
+"type": "string"
+},
+"storeApplicability": {
+"description": "Optional. Whether the promotion applies to [all stores, or only specified stores](https://support.google.com/merchants/answer/13857563?sjid=17642868584668136159-NC). Local Inventory ads promotions throw an error if no store applicability is included. An `INVALID_ARGUMENT` error is thrown if `store_applicability` is set to `ALL_STORES` and `store_codes_inclusion` or `score_code_exclusion` is set to a value.",
+"enum": [
+"STORE_APPLICABILITY_UNSPECIFIED",
+"ALL_STORES",
+"SPECIFIC_STORES"
+],
+"enumDescriptions": [
+"Which store codes the promotion applies to is unknown.",
+"Promotion applies to all stores.",
+"Promotion applies to only the specified stores."
+],
+"type": "string"
+},
+"storeCodesExclusion": {
+"description": "Optional. [Store codes to exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The store filter attributes only applies when the `store_applicability` attribute is set to [specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"storeCodesInclusion": {
+"description": "Optional. [Store codes to include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. The store filter attributes only applies when the `store_applicability` attribute is set to [specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC). Store code (the store ID from your Business Profile) of the physical store the product is sold in. See the [Local product inventory data specification](https://support.google.com/merchants/answer/3061342) for more information.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"CustomAttribute": {
+"description": "A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.",
+"id": "CustomAttribute",
+"properties": {
+"groupValues": {
+"description": "Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty.",
+"items": {
+"$ref": "CustomAttribute"
+},
+"type": "array"
+},
+"name": {
+"description": "The name of the attribute.",
+"type": "string"
+},
+"value": {
+"description": "The value of the attribute. If `value` is not empty, `group_values` must be empty.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"DestinationStatus": {
+"description": "The status for the specified destination.",
+"id": "DestinationStatus",
+"properties": {
+"reportingContext": {
+"description": "Output only. The name of the promotion destination.",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"description": "Output only. The status for the specified destination.",
+"enum": [
+"STATE_UNSPECIFIED",
+"IN_REVIEW",
+"REJECTED",
+"LIVE",
+"STOPPED",
+"EXPIRED",
+"PENDING"
+],
+"enumDescriptions": [
+"Unknown promotion state.",
+"The promotion is under review.",
+"The promotion is disapproved.",
+"The promotion is approved and active.",
+"The promotion is stopped by merchant.",
+"The promotion is no longer active.",
+"The promotion is not stopped, and all reviews are approved, but the active date is in the future."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"InsertPromotionRequest": {
+"description": "Request message for the `InsertPromotion` method.",
+"id": "InsertPromotionRequest",
+"properties": {
+"dataSource": {
+"description": "Required. The data source of the [promotion](https://support.google.com/merchants/answer/6396268?sjid=5155774230887277618-NC) Format: `accounts/{account}/dataSources/{datasource}`.",
+"type": "string"
+},
+"promotion": {
+"$ref": "Promotion",
+"description": "Required. The promotion to insert."
+}
+},
+"type": "object"
+},
+"Interval": {
+"description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.",
+"id": "Interval",
+"properties": {
+"endTime": {
+"description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.",
+"format": "google-datetime",
+"type": "string"
+},
+"startTime": {
+"description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ItemLevelIssue": {
+"description": "The issue associated with the promotion.",
+"id": "ItemLevelIssue",
+"properties": {
+"applicableCountries": {
+"description": "Output only. List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
+"attribute": {
+"description": "Output only. The attribute's name, if the issue is caused by a single attribute.",
+"readOnly": true,
+"type": "string"
+},
+"code": {
+"description": "Output only. The error code of the issue.",
+"readOnly": true,
+"type": "string"
+},
+"description": {
+"description": "Output only. A short issue description in English.",
+"readOnly": true,
+"type": "string"
+},
+"detail": {
+"description": "Output only. A detailed issue description in English.",
+"readOnly": true,
+"type": "string"
+},
+"documentation": {
+"description": "Output only. The URL of a web page to help with resolving this issue.",
+"readOnly": true,
+"type": "string"
+},
+"reportingContext": {
+"description": "Output only. The destination the issue applies to.",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"readOnly": true,
+"type": "string"
+},
+"resolution": {
+"description": "Output only. Whether the issue can be resolved by the merchant.",
+"readOnly": true,
+"type": "string"
+},
+"severity": {
+"description": "Output only. How this issue affects serving of the promotion.",
+"enum": [
+"SEVERITY_UNSPECIFIED",
+"NOT_IMPACTED",
+"DEMOTED",
+"DISAPPROVED"
+],
+"enumDescriptions": [
+"Not specified.",
+"This issue represents a warning and does not have a direct affect on the promotion.",
+"The promotion is demoted and most likely have limited performance in search results",
+"Issue disapproves the promotion."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"ListPromotionsResponse": {
+"description": "Response message for the `ListPromotions` method.",
+"id": "ListPromotionsResponse",
+"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"
+},
+"promotions": {
+"description": "The processed promotions from the specified account.",
+"items": {
+"$ref": "Promotion"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"Price": {
+"description": "The price represented as a number and currency.",
+"id": "Price",
+"properties": {
+"amountMicros": {
+"description": "The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).",
+"format": "int64",
+"type": "string"
+},
+"currencyCode": {
+"description": "The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductChange": {
+"description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.",
+"id": "ProductChange",
+"properties": {
+"newValue": {
+"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"oldValue": {
+"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"regionCode": {
+"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
+"type": "string"
+},
+"reportingContext": {
+"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductStatusChangeMessage": {
+"description": "The message that the merchant will receive to notify about product status change event",
+"id": "ProductStatusChangeMessage",
+"properties": {
+"account": {
+"description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`",
+"type": "string"
+},
+"attribute": {
+"description": "The attribute in the resource that changed, in this case it will be always `Status`.",
+"enum": [
+"ATTRIBUTE_UNSPECIFIED",
+"STATUS"
+],
+"enumDescriptions": [
+"Unspecified attribute",
+"Status of the changed entity"
+],
+"type": "string"
+},
+"changes": {
+"description": "A message to describe the change that happened to the product",
+"items": {
+"$ref": "ProductChange"
+},
+"type": "array"
+},
+"eventTime": {
+"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationTime": {
+"description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.",
+"format": "google-datetime",
+"type": "string"
+},
+"managingAccount": {
+"description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`",
+"type": "string"
+},
+"resource": {
+"description": "The product name. Format: `accounts/{account}/products/{product}`",
+"type": "string"
+},
+"resourceId": {
+"description": "The product id.",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource that changed, in this case it will always be `Product`.",
+"enum": [
+"RESOURCE_UNSPECIFIED",
+"PRODUCT"
+],
+"enumDescriptions": [
+"Unspecified resource",
+"Resource type : product"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"Promotion": {
+"description": "Represents a promotion. See the following articles for more details. Required promotion input attributes to pass data validation checks are primarily defined below: * [Promotions data specification](https://support.google.com/merchants/answer/2906014) * [Local promotions data specification](https://support.google.com/merchants/answer/10146130) After inserting, updating a promotion input, it may take several minutes before the final promotion can be retrieved.",
+"id": "Promotion",
+"properties": {
+"attributes": {
+"$ref": "Attributes",
+"description": "Optional. A list of promotion attributes."
+},
+"contentLanguage": {
+"description": "Required. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the promotion. Promotions is only for [selected languages](https://support.google.com/merchants/answer/4588281?ref_topic=6396150&sjid=18314938579342094533-NC#option3&zippy=).",
+"type": "string"
+},
+"customAttributes": {
+"description": "Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ \"name\": \"size type\", \"value\": \"regular\" }`). This is useful for submitting attributes not explicitly exposed by the API.",
+"items": {
+"$ref": "CustomAttribute"
+},
+"type": "array"
+},
+"dataSource": {
+"description": "Output only. The primary data source of the promotion.",
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Identifier. The name of the promotion. Format: `accounts/{account}/promotions/{promotion}`",
+"type": "string"
+},
+"promotionId": {
+"description": "Required. The user provided promotion ID to uniquely identify the promotion. Follow [minimum requirements](https://support.google.com/merchants/answer/7050148?ref_topic=7322920&sjid=871860036916537104-NC#minimum_requirements) to prevent promotion disapprovals.",
+"type": "string"
+},
+"promotionStatus": {
+"$ref": "PromotionStatus",
+"description": "Output only. The [status of a promotion](https://support.google.com/merchants/answer/3398326?ref_topic=7322924&sjid=5155774230887277618-NC), data validation issues, that is, information about a promotion computed asynchronously.",
+"readOnly": true
+},
+"redemptionChannel": {
+"description": "Required. [Redemption channel](https://support.google.com/merchants/answer/13837674?ref_topic=13773355&sjid=17642868584668136159-NC) for the promotion. At least one channel is required.",
+"items": {
+"enum": [
+"REDEMPTION_CHANNEL_UNSPECIFIED",
+"IN_STORE",
+"ONLINE"
+],
+"enumDescriptions": [
+"Indicates that the channel is unspecified.",
+"Indicates that the channel is in store. This is same as `local` channel used for `products`.",
+"Indicates that the channel is online."
+],
+"type": "string"
+},
+"type": "array"
+},
+"targetCountry": {
+"description": "Required. The target country used as part of the unique identifier. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). Promotions are only available in selected countries, [Free Listings and Shopping ads](https://support.google.com/merchants/answer/4588460) [Local Inventory ads](https://support.google.com/merchants/answer/10146326)",
+"type": "string"
+},
+"versionNumber": {
+"description": "Optional. Represents the existing version (freshness) of the promotion, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing promotion. Re-insertion (for example, promotion refresh after 30 days) can be performed with the current `version_number`. If the operation is prevented, the aborted exception will be thrown.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"PromotionStatus": {
+"description": "The status of the promotion.",
+"id": "PromotionStatus",
+"properties": {
+"creationDate": {
+"description": "Output only. Date on which the promotion has been created in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example `2020-01-02T09:00:00+01:00` or `2020-01-02T09:00:00Z`",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"destinationStatuses": {
+"description": "Output only. The intended destinations for the promotion.",
+"items": {
+"$ref": "DestinationStatus"
+},
+"readOnly": true,
+"type": "array"
+},
+"itemLevelIssues": {
+"description": "Output only. A list of issues associated with the promotion.",
+"items": {
+"$ref": "ItemLevelIssue"
+},
+"readOnly": true,
+"type": "array"
+},
+"lastUpdateDate": {
+"description": "Output only. Date on which the promotion status has been last updated in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example `2020-01-02T09:00:00+01:00` or `2020-01-02T09:00:00Z`",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+}
+},
+"servicePath": "",
+"title": "Merchant API",
+"version": "promotions_v1",
+"version_module": true
+}
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.promotions_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.promotions_v1beta.json
index de8bf9a799a..504dfb0b26c 100644
--- a/googleapiclient/discovery_cache/documents/merchantapi.promotions_v1beta.json
+++ b/googleapiclient/discovery_cache/documents/merchantapi.promotions_v1beta.json
@@ -172,13 +172,13 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "Output only. The maximum number of promotions to return. The service may return fewer than this value. The maximum value is 250; values above 250 will be coerced to 250. If unspecified, the maximum number of promotions will be returned.",
+"description": "Optional. The maximum number of promotions to return. The service may return fewer than this value. The maximum value is 250; values above 250 will be coerced to 250. If unspecified, the maximum number of promotions will be returned.",
 "format": "int32",
 "location": "query",
 "type": "integer"
 },
 "pageToken": {
-"description": "Output only. A page token, received from a previous `ListPromotions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPromotions` must match the call that provided the page token.",
+"description": "Optional. A page token, received from a previous `ListPromotions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPromotions` must match the call that provided the page token.",
 "location": "query",
 "type": "string"
 },
@@ -203,7 +203,7 @@
 }
 }
 },
-"revision": "20250727",
+"revision": "20250805",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "Attributes": {
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.quota_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.quota_v1.json
new file mode 100644
index 00000000000..09951d5928a
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/merchantapi.quota_v1.json
@@ -0,0 +1,393 @@
+{
+"auth": {
+"oauth2": {
+"scopes": {
+"https://www.googleapis.com/auth/content": {
+"description": "Manage your product listings and accounts for Google Shopping"
+}
+}
+}
+},
+"basePath": "",
+"baseUrl": "https://merchantapi.googleapis.com/",
+"batchPath": "batch",
+"canonicalName": "Merchant",
+"description": "Programmatically manage your Merchant Center Accounts.",
+"discoveryVersion": "v1",
+"documentationLink": "https://developers.google.com/merchant/api",
+"fullyEncodeReservedExpansion": true,
+"icons": {
+"x16": "http://www.google.com/images/icons/product/search-16.gif",
+"x32": "http://www.google.com/images/icons/product/search-32.gif"
+},
+"id": "merchantapi:quota_v1",
+"kind": "discovery#restDescription",
+"mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/",
+"name": "merchantapi",
+"ownerDomain": "google.com",
+"ownerName": "Google",
+"parameters": {
+"$.xgafv": {
+"description": "V1 error format.",
+"enum": [
+"1",
+"2"
+],
+"enumDescriptions": [
+"v1 error format",
+"v2 error format"
+],
+"location": "query",
+"type": "string"
+},
+"access_token": {
+"description": "OAuth access token.",
+"location": "query",
+"type": "string"
+},
+"alt": {
+"default": "json",
+"description": "Data format for response.",
+"enum": [
+"json",
+"media",
+"proto"
+],
+"enumDescriptions": [
+"Responses with Content-Type of application/json",
+"Media download with context-dependent Content-Type",
+"Responses with Content-Type of application/x-protobuf"
+],
+"location": "query",
+"type": "string"
+},
+"callback": {
+"description": "JSONP",
+"location": "query",
+"type": "string"
+},
+"fields": {
+"description": "Selector specifying which fields to include in a partial response.",
+"location": "query",
+"type": "string"
+},
+"key": {
+"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+"location": "query",
+"type": "string"
+},
+"oauth_token": {
+"description": "OAuth 2.0 token for the current user.",
+"location": "query",
+"type": "string"
+},
+"prettyPrint": {
+"default": "true",
+"description": "Returns response with indentations and line breaks.",
+"location": "query",
+"type": "boolean"
+},
+"quotaUser": {
+"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+"location": "query",
+"type": "string"
+},
+"uploadType": {
+"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+"location": "query",
+"type": "string"
+},
+"upload_protocol": {
+"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+"location": "query",
+"type": "string"
+}
+},
+"protocol": "rest",
+"resources": {
+"accounts": {
+"resources": {
+"quotas": {
+"methods": {
+"list": {
+"description": "Lists the daily call quota and usage per group for your Merchant Center account.",
+"flatPath": "quota/v1/accounts/{accountsId}/quotas",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.quotas.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of quotas to return in the response, used for paging. Defaults to 500; values above 1000 will be coerced to 1000.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The merchant account who owns the collection of method quotas Format: accounts/{account}",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "quota/v1/{+parent}/quotas",
+"response": {
+"$ref": "ListQuotaGroupsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+}
+},
+"revision": "20250804",
+"rootUrl": "https://merchantapi.googleapis.com/",
+"schemas": {
+"ListQuotaGroupsResponse": {
+"description": "Response message for the ListMethodGroups method.",
+"id": "ListQuotaGroupsResponse",
+"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"
+},
+"quotaGroups": {
+"description": "The methods, current quota usage and limits per each group. The quota is shared between all methods in the group. The groups are sorted in descending order based on quota_usage.",
+"items": {
+"$ref": "QuotaGroup"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"MethodDetails": {
+"description": "The method details per method in the Merchant API.",
+"id": "MethodDetails",
+"properties": {
+"method": {
+"description": "Output only. The name of the method for example `products.list`.",
+"readOnly": true,
+"type": "string"
+},
+"path": {
+"description": "Output only. The path for the method such as `products/v1/productInputs.insert`",
+"readOnly": true,
+"type": "string"
+},
+"subapi": {
+"description": "Output only. The sub-API that the method belongs to.",
+"readOnly": true,
+"type": "string"
+},
+"version": {
+"description": "Output only. The API version that the method belongs to.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductChange": {
+"description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.",
+"id": "ProductChange",
+"properties": {
+"newValue": {
+"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"oldValue": {
+"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"regionCode": {
+"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
+"type": "string"
+},
+"reportingContext": {
+"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductStatusChangeMessage": {
+"description": "The message that the merchant will receive to notify about product status change event",
+"id": "ProductStatusChangeMessage",
+"properties": {
+"account": {
+"description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`",
+"type": "string"
+},
+"attribute": {
+"description": "The attribute in the resource that changed, in this case it will be always `Status`.",
+"enum": [
+"ATTRIBUTE_UNSPECIFIED",
+"STATUS"
+],
+"enumDescriptions": [
+"Unspecified attribute",
+"Status of the changed entity"
+],
+"type": "string"
+},
+"changes": {
+"description": "A message to describe the change that happened to the product",
+"items": {
+"$ref": "ProductChange"
+},
+"type": "array"
+},
+"eventTime": {
+"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationTime": {
+"description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.",
+"format": "google-datetime",
+"type": "string"
+},
+"managingAccount": {
+"description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`",
+"type": "string"
+},
+"resource": {
+"description": "The product name. Format: `accounts/{account}/products/{product}`",
+"type": "string"
+},
+"resourceId": {
+"description": "The product id.",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource that changed, in this case it will always be `Product`.",
+"enum": [
+"RESOURCE_UNSPECIFIED",
+"PRODUCT"
+],
+"enumDescriptions": [
+"Unspecified resource",
+"Resource type : product"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"QuotaGroup": {
+"description": "The group information for methods in the Merchant API. The quota is shared between all methods in the group. Even if none of the methods within the group have usage the information for the group is returned.",
+"id": "QuotaGroup",
+"properties": {
+"methodDetails": {
+"description": "Output only. List of all methods group quota applies to.",
+"items": {
+"$ref": "MethodDetails"
+},
+"readOnly": true,
+"type": "array"
+},
+"name": {
+"description": "Identifier. The resource name of the quota group. Format: accounts/{account}/quotas/{group} Note: There is no guarantee on the format of {group}",
+"type": "string"
+},
+"quotaLimit": {
+"description": "Output only. The maximum number of calls allowed per day for the group.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"quotaMinuteLimit": {
+"description": "Output only. The maximum number of calls allowed per minute for the group.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"quotaUsage": {
+"description": "Output only. The current quota usage, meaning the number of calls already made on a given day to the methods in the group. The daily quota limits reset at at 12:00 PM midday UTC.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+}
+},
+"servicePath": "",
+"title": "Merchant API",
+"version": "quota_v1",
+"version_module": true
+}
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.reports_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.reports_v1.json
new file mode 100644
index 00000000000..28c9ce1f758
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/merchantapi.reports_v1.json
@@ -0,0 +1,1550 @@
+{
+"auth": {
+"oauth2": {
+"scopes": {
+"https://www.googleapis.com/auth/content": {
+"description": "Manage your product listings and accounts for Google Shopping"
+}
+}
+}
+},
+"basePath": "",
+"baseUrl": "https://merchantapi.googleapis.com/",
+"batchPath": "batch",
+"canonicalName": "Merchant",
+"description": "Programmatically manage your Merchant Center Accounts.",
+"discoveryVersion": "v1",
+"documentationLink": "https://developers.google.com/merchant/api",
+"fullyEncodeReservedExpansion": true,
+"icons": {
+"x16": "http://www.google.com/images/icons/product/search-16.gif",
+"x32": "http://www.google.com/images/icons/product/search-32.gif"
+},
+"id": "merchantapi:reports_v1",
+"kind": "discovery#restDescription",
+"mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/",
+"name": "merchantapi",
+"ownerDomain": "google.com",
+"ownerName": "Google",
+"parameters": {
+"$.xgafv": {
+"description": "V1 error format.",
+"enum": [
+"1",
+"2"
+],
+"enumDescriptions": [
+"v1 error format",
+"v2 error format"
+],
+"location": "query",
+"type": "string"
+},
+"access_token": {
+"description": "OAuth access token.",
+"location": "query",
+"type": "string"
+},
+"alt": {
+"default": "json",
+"description": "Data format for response.",
+"enum": [
+"json",
+"media",
+"proto"
+],
+"enumDescriptions": [
+"Responses with Content-Type of application/json",
+"Media download with context-dependent Content-Type",
+"Responses with Content-Type of application/x-protobuf"
+],
+"location": "query",
+"type": "string"
+},
+"callback": {
+"description": "JSONP",
+"location": "query",
+"type": "string"
+},
+"fields": {
+"description": "Selector specifying which fields to include in a partial response.",
+"location": "query",
+"type": "string"
+},
+"key": {
+"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+"location": "query",
+"type": "string"
+},
+"oauth_token": {
+"description": "OAuth 2.0 token for the current user.",
+"location": "query",
+"type": "string"
+},
+"prettyPrint": {
+"default": "true",
+"description": "Returns response with indentations and line breaks.",
+"location": "query",
+"type": "boolean"
+},
+"quotaUser": {
+"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+"location": "query",
+"type": "string"
+},
+"uploadType": {
+"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+"location": "query",
+"type": "string"
+},
+"upload_protocol": {
+"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+"location": "query",
+"type": "string"
+}
+},
+"protocol": "rest",
+"resources": {
+"accounts": {
+"resources": {
+"reports": {
+"methods": {
+"search": {
+"description": "Retrieves a report defined by a search query. The response might contain fewer rows than specified by `page_size`. Rely on `next_page_token` to determine if there are more rows to be requested.",
+"flatPath": "reports/v1/accounts/{accountsId}/reports:search",
+"httpMethod": "POST",
+"id": "merchantapi.accounts.reports.search",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. Id of the account making the call. Must be a standalone account or an MCA subaccount. Format: accounts/{account}",
+"location": "path",
+"pattern": "^accounts/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "reports/v1/{+parent}/reports:search",
+"request": {
+"$ref": "SearchRequest"
+},
+"response": {
+"$ref": "SearchResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+}
+}
+}
+}
+}
+},
+"revision": "20250804",
+"rootUrl": "https://merchantapi.googleapis.com/",
+"schemas": {
+"BestSellersBrandView": {
+"description": "Fields available for query in `best_sellers_brand_view` table. [Best sellers](https://support.google.com/merchants/answer/9488679) report with top brands. Values are only set for fields requested explicitly in the request's search query.",
+"id": "BestSellersBrandView",
+"properties": {
+"brand": {
+"description": "Name of the brand.",
+"type": "string"
+},
+"previousRank": {
+"description": "Popularity rank in the previous week or month.",
+"format": "int64",
+"type": "string"
+},
+"previousRelativeDemand": {
+"description": "Estimated demand in relation to the brand with the highest popularity rank in the same category and country in the previous week or month.",
+"enum": [
+"RELATIVE_DEMAND_ENUM_UNSPECIFIED",
+"VERY_LOW",
+"LOW",
+"MEDIUM",
+"HIGH",
+"VERY_HIGH"
+],
+"enumDescriptions": [
+"Not specified.",
+"Demand is 0-5% of the demand of the highest ranked product cluster or brand.",
+"Demand is 6-10% of the demand of the highest ranked product cluster or brand.",
+"Demand is 11-20% of the demand of the highest ranked product cluster or brand.",
+"Demand is 21-50% of the demand of the highest ranked product cluster or brand.",
+"Demand is 51-100% of the demand of the highest ranked product cluster or brand."
+],
+"type": "string"
+},
+"rank": {
+"description": "Popularity of the brand on Ads and organic surfaces, in the selected category and country, based on the estimated number of units sold.",
+"format": "int64",
+"type": "string"
+},
+"relativeDemand": {
+"description": "Estimated demand in relation to the brand with the highest popularity rank in the same category and country.",
+"enum": [
+"RELATIVE_DEMAND_ENUM_UNSPECIFIED",
+"VERY_LOW",
+"LOW",
+"MEDIUM",
+"HIGH",
+"VERY_HIGH"
+],
+"enumDescriptions": [
+"Not specified.",
+"Demand is 0-5% of the demand of the highest ranked product cluster or brand.",
+"Demand is 6-10% of the demand of the highest ranked product cluster or brand.",
+"Demand is 11-20% of the demand of the highest ranked product cluster or brand.",
+"Demand is 21-50% of the demand of the highest ranked product cluster or brand.",
+"Demand is 51-100% of the demand of the highest ranked product cluster or brand."
+],
+"type": "string"
+},
+"relativeDemandChange": {
+"description": "Change in the estimated demand. Whether it rose, sank or remained flat.",
+"enum": [
+"RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED",
+"SINKER",
+"FLAT",
+"RISER"
+],
+"enumDescriptions": [
+"Not specified.",
+"Relative demand is lower than the previous time period.",
+"Relative demand is equal to the previous time period.",
+"Relative demand is higher than the previous time period."
+],
+"type": "string"
+},
+"reportCategoryId": {
+"description": "Google product category ID to calculate the ranking for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. If a `WHERE` condition on `report_category_id` is not specified in the query, rankings for all top-level categories are returned.",
+"format": "int64",
+"type": "string"
+},
+"reportCountryCode": {
+"description": "Country where the ranking is calculated. Represented in the ISO 3166 format. Required in the `SELECT` clause. Condition on `report_country_code` is required in the `WHERE` clause.",
+"type": "string"
+},
+"reportDate": {
+"$ref": "Date",
+"description": "Report date. The value of this field can only be one of the following: * The first day of the week (Monday) for weekly reports, * The first day of the month for monthly reports. Required in the `SELECT` clause. If a `WHERE` condition on `report_date` is not specified in the query, the latest available weekly or monthly report is returned."
+},
+"reportGranularity": {
+"description": "Granularity of the report. The ranking can be done over a week or a month timeframe. Required in the `SELECT` clause. Condition on `report_granularity` is required in the `WHERE` clause.",
+"enum": [
+"REPORT_GRANULARITY_ENUM_UNSPECIFIED",
+"WEEKLY",
+"MONTHLY"
+],
+"enumDescriptions": [
+"Not specified.",
+"Report is computed over a week timeframe.",
+"Report is computed over a month timeframe."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"BestSellersProductClusterView": {
+"description": "Fields available for query in `best_sellers_product_cluster_view` table. [Best sellers](https://support.google.com/merchants/answer/9488679) report with top product clusters. A product cluster is a grouping for different offers and variants that represent the same product, for example, Google Pixel 7. Values are only set for fields requested explicitly in the request's search query.",
+"id": "BestSellersProductClusterView",
+"properties": {
+"brand": {
+"description": "Brand of the product cluster.",
+"type": "string"
+},
+"brandInventoryStatus": {
+"description": "Whether there is at least one product of the brand currently `IN_STOCK` in your product data source in at least one of the countries, all products are `OUT_OF_STOCK` in your product data source in all countries, or `NOT_IN_INVENTORY`. The field doesn't take the Best sellers report country filter into account.",
+"enum": [
+"INVENTORY_STATUS_UNSPECIFIED",
+"IN_STOCK",
+"OUT_OF_STOCK",
+"NOT_IN_INVENTORY"
+],
+"enumDescriptions": [
+"Not specified.",
+"You have a product for this product cluster or brand in stock.",
+"You have a product for this product cluster or brand in inventory but it is currently out of stock.",
+"You do not have a product for this product cluster or brand in inventory."
+],
+"type": "string"
+},
+"categoryL1": {
+"description": "Product category (1st level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL2": {
+"description": "Product category (2nd level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL3": {
+"description": "Product category (3rd level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL4": {
+"description": "Product category (4th level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL5": {
+"description": "Product category (5th level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"inventoryStatus": {
+"description": "Whether the product cluster is `IN_STOCK` in your product data source in at least one of the countries, `OUT_OF_STOCK` in your product data source in all countries, or `NOT_IN_INVENTORY` at all. The field doesn't take the Best sellers report country filter into account.",
+"enum": [
+"INVENTORY_STATUS_UNSPECIFIED",
+"IN_STOCK",
+"OUT_OF_STOCK",
+"NOT_IN_INVENTORY"
+],
+"enumDescriptions": [
+"Not specified.",
+"You have a product for this product cluster or brand in stock.",
+"You have a product for this product cluster or brand in inventory but it is currently out of stock.",
+"You do not have a product for this product cluster or brand in inventory."
+],
+"type": "string"
+},
+"previousRank": {
+"description": "Popularity rank in the previous week or month.",
+"format": "int64",
+"type": "string"
+},
+"previousRelativeDemand": {
+"description": "Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country in the previous week or month.",
+"enum": [
+"RELATIVE_DEMAND_ENUM_UNSPECIFIED",
+"VERY_LOW",
+"LOW",
+"MEDIUM",
+"HIGH",
+"VERY_HIGH"
+],
+"enumDescriptions": [
+"Not specified.",
+"Demand is 0-5% of the demand of the highest ranked product cluster or brand.",
+"Demand is 6-10% of the demand of the highest ranked product cluster or brand.",
+"Demand is 11-20% of the demand of the highest ranked product cluster or brand.",
+"Demand is 21-50% of the demand of the highest ranked product cluster or brand.",
+"Demand is 51-100% of the demand of the highest ranked product cluster or brand."
+],
+"type": "string"
+},
+"rank": {
+"description": "Popularity of the product cluster on Ads and organic surfaces, in the selected category and country, based on the estimated number of units sold.",
+"format": "int64",
+"type": "string"
+},
+"relativeDemand": {
+"description": "Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country.",
+"enum": [
+"RELATIVE_DEMAND_ENUM_UNSPECIFIED",
+"VERY_LOW",
+"LOW",
+"MEDIUM",
+"HIGH",
+"VERY_HIGH"
+],
+"enumDescriptions": [
+"Not specified.",
+"Demand is 0-5% of the demand of the highest ranked product cluster or brand.",
+"Demand is 6-10% of the demand of the highest ranked product cluster or brand.",
+"Demand is 11-20% of the demand of the highest ranked product cluster or brand.",
+"Demand is 21-50% of the demand of the highest ranked product cluster or brand.",
+"Demand is 51-100% of the demand of the highest ranked product cluster or brand."
+],
+"type": "string"
+},
+"relativeDemandChange": {
+"description": "Change in the estimated demand. Whether it rose, sank or remained flat.",
+"enum": [
+"RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED",
+"SINKER",
+"FLAT",
+"RISER"
+],
+"enumDescriptions": [
+"Not specified.",
+"Relative demand is lower than the previous time period.",
+"Relative demand is equal to the previous time period.",
+"Relative demand is higher than the previous time period."
+],
+"type": "string"
+},
+"reportCategoryId": {
+"description": "Google product category ID to calculate the ranking for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. If a `WHERE` condition on `report_category_id` is not specified in the query, rankings for all top-level categories are returned.",
+"format": "int64",
+"type": "string"
+},
+"reportCountryCode": {
+"description": "Country where the ranking is calculated. Represented in the ISO 3166 format. Required in the `SELECT` clause. Condition on `report_country_code` is required in the `WHERE` clause.",
+"type": "string"
+},
+"reportDate": {
+"$ref": "Date",
+"description": "Report date. The value of this field can only be one of the following: * The first day of the week (Monday) for weekly reports, * The first day of the month for monthly reports. Required in the `SELECT` clause. If a `WHERE` condition on `report_date` is not specified in the query, the latest available weekly or monthly report is returned."
+},
+"reportGranularity": {
+"description": "Granularity of the report. The ranking can be done over a week or a month timeframe. Required in the `SELECT` clause. Condition on `report_granularity` is required in the `WHERE` clause.",
+"enum": [
+"REPORT_GRANULARITY_ENUM_UNSPECIFIED",
+"WEEKLY",
+"MONTHLY"
+],
+"enumDescriptions": [
+"Not specified.",
+"Report is computed over a week timeframe.",
+"Report is computed over a month timeframe."
+],
+"type": "string"
+},
+"title": {
+"description": "Title of the product cluster.",
+"type": "string"
+},
+"variantGtins": {
+"description": "GTINs of example variants of the product cluster.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"CompetitiveVisibilityBenchmarkView": {
+"description": "Fields available for query in `competitive_visibility_benchmark_view` table. [Competitive visibility](https://support.google.com/merchants/answer/11366442) report with the category benchmark. Values are only set for fields requested explicitly in the request's search query.",
+"id": "CompetitiveVisibilityBenchmarkView",
+"properties": {
+"categoryBenchmarkVisibilityTrend": {
+"description": "Change in visibility based on impressions with respect to the start of the selected time range (or first day with non-zero impressions) for a combined set of merchants with highest visibility approximating the market. Cannot be filtered on in the 'WHERE' clause.",
+"format": "double",
+"type": "number"
+},
+"date": {
+"$ref": "Date",
+"description": "Date of this row. Required in the `SELECT` clause. A condition on `date` is required in the `WHERE` clause."
+},
+"reportCategoryId": {
+"description": "Google product category ID to calculate the report for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. A condition on `report_category_id` is required in the `WHERE` clause.",
+"format": "int64",
+"type": "string"
+},
+"reportCountryCode": {
+"description": "Country where impressions appeared. Required in the `SELECT` clause. A condition on `report_country_code` is required in the `WHERE` clause.",
+"type": "string"
+},
+"trafficSource": {
+"description": "Traffic source of impressions. Required in the `SELECT` clause.",
+"enum": [
+"TRAFFIC_SOURCE_ENUM_UNSPECIFIED",
+"ORGANIC",
+"ADS",
+"ALL"
+],
+"enumDescriptions": [
+"Not specified.",
+"Organic traffic.",
+"Traffic from ads.",
+"Organic and ads traffic."
+],
+"type": "string"
+},
+"yourDomainVisibilityTrend": {
+"description": "Change in visibility based on impressions for your domain with respect to the start of the selected time range (or first day with non-zero impressions). Cannot be filtered on in the 'WHERE' clause.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"CompetitiveVisibilityCompetitorView": {
+"description": "Fields available for query in `competitive_visibility_competitor_view` table. [Competitive visibility](https://support.google.com/merchants/answer/11366442) report with businesses with similar visibility. Values are only set for fields requested explicitly in the request's search query.",
+"id": "CompetitiveVisibilityCompetitorView",
+"properties": {
+"adsOrganicRatio": {
+"description": "[Ads / organic ratio] (https://support.google.com/merchants/answer/11366442#zippy=%2Cads-free-ratio) shows how often the domain receives impressions from Shopping ads compared to organic traffic. The number is rounded and bucketed. Cannot be filtered on in the 'WHERE' clause.",
+"format": "double",
+"type": "number"
+},
+"date": {
+"$ref": "Date",
+"description": "Date of this row. A condition on `date` is required in the `WHERE` clause."
+},
+"domain": {
+"description": "Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.",
+"type": "string"
+},
+"higherPositionRate": {
+"description": "[Higher position rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Chigher-position-rate) shows how often a competitor\u2019s offer got placed in a higher position on the page than your offer. Cannot be filtered on in the 'WHERE' clause.",
+"format": "double",
+"type": "number"
+},
+"isYourDomain": {
+"description": "True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause.",
+"type": "boolean"
+},
+"pageOverlapRate": {
+"description": "[Page overlap rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Cpage-overlap-rate) shows how frequently competing retailers\u2019 offers are shown together with your offers on the same page. Cannot be filtered on in the 'WHERE' clause.",
+"format": "double",
+"type": "number"
+},
+"rank": {
+"description": "Position of the domain in the similar businesses ranking for the selected keys (`date`, `report_category_id`, `report_country_code`, `traffic_source`) based on impressions. 1 is the highest. Cannot be filtered on in the 'WHERE' clause.",
+"format": "int64",
+"type": "string"
+},
+"relativeVisibility": {
+"description": "[Relative visibility] (https://support.google.com/merchants/answer/11366442#zippy=%2Crelative-visibility) shows how often your competitors\u2019 offers are shown compared to your offers. In other words, this is the number of displayed impressions of a competitor retailer divided by the number of your displayed impressions during a selected time range for a selected product category and country. Cannot be filtered on in the 'WHERE' clause.",
+"format": "double",
+"type": "number"
+},
+"reportCategoryId": {
+"description": "Google product category ID to calculate the report for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. A condition on `report_category_id` is required in the `WHERE` clause.",
+"format": "int64",
+"type": "string"
+},
+"reportCountryCode": {
+"description": "Country where impressions appeared. Required in the `SELECT` clause. A condition on `report_country_code` is required in the `WHERE` clause.",
+"type": "string"
+},
+"trafficSource": {
+"description": "Traffic source of impressions. Required in the `SELECT` clause.",
+"enum": [
+"TRAFFIC_SOURCE_ENUM_UNSPECIFIED",
+"ORGANIC",
+"ADS",
+"ALL"
+],
+"enumDescriptions": [
+"Not specified.",
+"Organic traffic.",
+"Traffic from ads.",
+"Organic and ads traffic."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"CompetitiveVisibilityTopMerchantView": {
+"description": "Fields available for query in `competitive_visibility_top_merchant_view` table. [Competitive visibility](https://support.google.com/merchants/answer/11366442) report with business with highest visibility. Values are only set for fields requested explicitly in the request's search query.",
+"id": "CompetitiveVisibilityTopMerchantView",
+"properties": {
+"adsOrganicRatio": {
+"description": "[Ads / organic ratio] (https://support.google.com/merchants/answer/11366442#zippy=%2Cads-free-ratio) shows how often the domain receives impressions from Shopping ads compared to organic traffic. The number is rounded and bucketed. Cannot be filtered on in the 'WHERE' clause.",
+"format": "double",
+"type": "number"
+},
+"date": {
+"$ref": "Date",
+"description": "Date of this row. Cannot be selected in the `SELECT` clause. A condition on `date` is required in the `WHERE` clause."
+},
+"domain": {
+"description": "Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.",
+"type": "string"
+},
+"higherPositionRate": {
+"description": "[Higher position rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Chigher-position-rate) shows how often a competitor\u2019s offer got placed in a higher position on the page than your offer. Cannot be filtered on in the 'WHERE' clause.",
+"format": "double",
+"type": "number"
+},
+"isYourDomain": {
+"description": "True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause.",
+"type": "boolean"
+},
+"pageOverlapRate": {
+"description": "[Page overlap rate] (https://support.google.com/merchants/answer/11366442#zippy=%2Cpage-overlap-rate) shows how frequently competing retailers\u2019 offers are shown together with your offers on the same page. Cannot be filtered on in the 'WHERE' clause.",
+"format": "double",
+"type": "number"
+},
+"rank": {
+"description": "Position of the domain in the top merchants ranking for the selected keys (`date`, `report_category_id`, `report_country_code`, `traffic_source`) based on impressions. 1 is the highest. Cannot be filtered on in the 'WHERE' clause.",
+"format": "int64",
+"type": "string"
+},
+"reportCategoryId": {
+"description": "Google product category ID to calculate the report for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. A condition on `report_category_id` is required in the `WHERE` clause.",
+"format": "int64",
+"type": "string"
+},
+"reportCountryCode": {
+"description": "Country where impressions appeared. Required in the `SELECT` clause. A condition on `report_country_code` is required in the `WHERE` clause.",
+"type": "string"
+},
+"trafficSource": {
+"description": "Traffic source of impressions. Required in the `SELECT` clause.",
+"enum": [
+"TRAFFIC_SOURCE_ENUM_UNSPECIFIED",
+"ORGANIC",
+"ADS",
+"ALL"
+],
+"enumDescriptions": [
+"Not specified.",
+"Organic traffic.",
+"Traffic from ads.",
+"Organic and ads traffic."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"Date": {
+"description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp",
+"id": "Date",
+"properties": {
+"day": {
+"description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.",
+"format": "int32",
+"type": "integer"
+},
+"month": {
+"description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.",
+"format": "int32",
+"type": "integer"
+},
+"year": {
+"description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
+"IssueSeverityPerReportingContext": {
+"description": "Issue severity per reporting context.",
+"id": "IssueSeverityPerReportingContext",
+"properties": {
+"demotedCountries": {
+"description": "List of demoted countries in the reporting context, represented in ISO 3166 format.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"disapprovedCountries": {
+"description": "List of disapproved countries in the reporting context, represented in ISO 3166 format.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"reportingContext": {
+"description": "Reporting context the issue applies to.",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ItemIssue": {
+"description": "Item issue associated with the product.",
+"id": "ItemIssue",
+"properties": {
+"resolution": {
+"description": "Item issue resolution.",
+"enum": [
+"ITEM_ISSUE_RESOLUTION_UNSPECIFIED",
+"MERCHANT_ACTION",
+"PENDING_PROCESSING"
+],
+"enumDescriptions": [
+"Not specified.",
+"The merchant has to fix the issue.",
+"The issue will be resolved automatically (for example, image crawl) or through a Google review. No merchant action is required now. Resolution might lead to another issue (for example, if crawl fails)."
+],
+"type": "string"
+},
+"severity": {
+"$ref": "ItemIssueSeverity",
+"description": "Item issue severity."
+},
+"type": {
+"$ref": "ItemIssueType",
+"description": "Item issue type."
+}
+},
+"type": "object"
+},
+"ItemIssueSeverity": {
+"description": "How the issue affects the serving of the product.",
+"id": "ItemIssueSeverity",
+"properties": {
+"aggregatedSeverity": {
+"description": "Aggregated severity of the issue for all reporting contexts it affects. **This field can be used for filtering the results.**",
+"enum": [
+"AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED",
+"DISAPPROVED",
+"DEMOTED",
+"PENDING"
+],
+"enumDescriptions": [
+"Not specified.",
+"Issue disapproves the product in at least one reporting context.",
+"Issue demotes the product in all reporting contexts it affects.",
+"Issue resolution is `PENDING_PROCESSING`."
+],
+"type": "string"
+},
+"severityPerReportingContext": {
+"description": "Issue severity per reporting context.",
+"items": {
+"$ref": "IssueSeverityPerReportingContext"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"ItemIssueType": {
+"description": "Issue type.",
+"id": "ItemIssueType",
+"properties": {
+"canonicalAttribute": {
+"description": "Canonical attribute name for attribute-specific issues.",
+"type": "string"
+},
+"code": {
+"description": "Error code of the issue, equivalent to the `code` of [Product issues](https://developers.google.com/shopping-content/guides/product-issues).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"NonProductPerformanceView": {
+"description": "Fields available for query in `non_product_performance_view` table. Performance data on images and online store links leading to your non-product pages. This includes performance metrics (for example, `clicks`) and dimensions according to which performance metrics are segmented (for example, `date`). Segment fields cannot be selected in queries without also selecting at least one metric field. Values are only set for fields requested explicitly in the request's search query.",
+"id": "NonProductPerformanceView",
+"properties": {
+"clickThroughRate": {
+"description": "Click-through rate - the number of clicks (`clicks`) divided by the number of impressions (`impressions`) of images and online store links leading to your non-product pages. Metric.",
+"format": "double",
+"type": "number"
+},
+"clicks": {
+"description": "Number of clicks on images and online store links leading to your non-product pages. Metric.",
+"format": "int64",
+"type": "string"
+},
+"date": {
+"$ref": "Date",
+"description": "Date in the merchant timezone to which metrics apply. Segment. Condition on `date` is required in the `WHERE` clause."
+},
+"impressions": {
+"description": "Number of times images and online store links leading to your non-product pages were shown. Metric.",
+"format": "int64",
+"type": "string"
+},
+"week": {
+"$ref": "Date",
+"description": "First day of the week (Monday) of the metrics date in the merchant timezone. Segment."
+}
+},
+"type": "object"
+},
+"Price": {
+"description": "The price represented as a number and currency.",
+"id": "Price",
+"properties": {
+"amountMicros": {
+"description": "The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).",
+"format": "int64",
+"type": "string"
+},
+"currencyCode": {
+"description": "The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"PriceCompetitivenessProductView": {
+"description": "Fields available for query in `price_competitiveness_product_view` table. [Price competitiveness](https://support.google.com/merchants/answer/9626903) report. Values are only set for fields requested explicitly in the request's search query.",
+"id": "PriceCompetitivenessProductView",
+"properties": {
+"benchmarkPrice": {
+"$ref": "Price",
+"description": "Latest available price benchmark for the product's catalog in the benchmark country."
+},
+"brand": {
+"description": "Brand of the product.",
+"type": "string"
+},
+"categoryL1": {
+"description": "Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL2": {
+"description": "Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL3": {
+"description": "Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL4": {
+"description": "Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL5": {
+"description": "Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"id": {
+"description": "REST ID of the product, in the form of `channel~languageCode~feedLabel~offerId`. Can be used to join data with the `product_view` table. Required in the `SELECT` clause.",
+"type": "string"
+},
+"offerId": {
+"description": "Merchant-provided id of the product.",
+"type": "string"
+},
+"price": {
+"$ref": "Price",
+"description": "Current price of the product."
+},
+"productTypeL1": {
+"description": "Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL2": {
+"description": "Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL3": {
+"description": "Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL4": {
+"description": "Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL5": {
+"description": "Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"reportCountryCode": {
+"description": "Country of the price benchmark. Represented in the ISO 3166 format. Required in the `SELECT` clause.",
+"type": "string"
+},
+"title": {
+"description": "Title of the product.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"PriceInsightsProductView": {
+"description": "Fields available for query in `price_insights_product_view` table. [Price insights](https://support.google.com/merchants/answer/11916926) report. Values are only set for fields requested explicitly in the request's search query.",
+"id": "PriceInsightsProductView",
+"properties": {
+"brand": {
+"description": "Brand of the product.",
+"type": "string"
+},
+"categoryL1": {
+"description": "Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL2": {
+"description": "Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL3": {
+"description": "Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL4": {
+"description": "Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL5": {
+"description": "Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"effectiveness": {
+"description": "The predicted effectiveness of applying the price suggestion, bucketed.",
+"enum": [
+"EFFECTIVENESS_UNSPECIFIED",
+"LOW",
+"MEDIUM",
+"HIGH"
+],
+"enumDescriptions": [
+"Effectiveness is unknown.",
+"Effectiveness is low.",
+"Effectiveness is medium.",
+"Effectiveness is high."
+],
+"type": "string"
+},
+"id": {
+"description": "REST ID of the product, in the form of `channel~languageCode~feedLabel~offerId`. Can be used to join data with the `product_view` table. Required in the `SELECT` clause.",
+"type": "string"
+},
+"offerId": {
+"description": "Merchant-provided id of the product.",
+"type": "string"
+},
+"predictedClicksChangeFraction": {
+"description": "Predicted change in clicks as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in clicks.",
+"format": "double",
+"type": "number"
+},
+"predictedConversionsChangeFraction": {
+"description": "Predicted change in conversions as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in conversions).",
+"format": "double",
+"type": "number"
+},
+"predictedImpressionsChangeFraction": {
+"description": "Predicted change in impressions as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in impressions.",
+"format": "double",
+"type": "number"
+},
+"price": {
+"$ref": "Price",
+"description": "Current price of the product."
+},
+"productTypeL1": {
+"description": "Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL2": {
+"description": "Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL3": {
+"description": "Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL4": {
+"description": "Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL5": {
+"description": "Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"suggestedPrice": {
+"$ref": "Price",
+"description": "Latest suggested price for the product."
+},
+"title": {
+"description": "Title of the product.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductChange": {
+"description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.",
+"id": "ProductChange",
+"properties": {
+"newValue": {
+"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"oldValue": {
+"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
+"type": "string"
+},
+"regionCode": {
+"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
+"type": "string"
+},
+"reportingContext": {
+"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
+"enum": [
+"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
+"SHOPPING_ADS",
+"DISCOVERY_ADS",
+"DEMAND_GEN_ADS",
+"DEMAND_GEN_ADS_DISCOVER_SURFACE",
+"VIDEO_ADS",
+"DISPLAY_ADS",
+"LOCAL_INVENTORY_ADS",
+"VEHICLE_INVENTORY_ADS",
+"FREE_LISTINGS",
+"FREE_LOCAL_LISTINGS",
+"FREE_LOCAL_VEHICLE_LISTINGS",
+"YOUTUBE_AFFILIATE",
+"YOUTUBE_SHOPPING",
+"CLOUD_RETAIL",
+"LOCAL_CLOUD_RETAIL",
+"PRODUCT_REVIEWS",
+"MERCHANT_REVIEWS",
+"YOUTUBE_CHECKOUT"
+],
+"enumDeprecated": [
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Not specified.",
+"[Shopping ads](https://support.google.com/merchants/answer/6149970).",
+"Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads](https://support.google.com/merchants/answer/13389785).",
+"[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).",
+"[Video ads](https://support.google.com/google-ads/answer/6340491).",
+"[Display ads](https://support.google.com/merchants/answer/6069387).",
+"[Local inventory ads](https://support.google.com/merchants/answer/3271956).",
+"[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).",
+"[Free product listings](https://support.google.com/merchants/answer/9199328).",
+"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
+"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
+"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
+"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
+"[Cloud retail](https://cloud.google.com/solutions/retail).",
+"[Local cloud retail](https://cloud.google.com/solutions/retail).",
+"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
+"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
+"YouTube Checkout ."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductPerformanceView": {
+"description": "Fields available for query in `product_performance_view` table. Product performance data for your account, including performance metrics (for example, `clicks`) and dimensions according to which performance metrics are segmented (for example, `offer_id`). Values of product dimensions, such as `offer_id`, reflect the state of a product at the time of the impression. Segment fields cannot be selected in queries without also selecting at least one metric field. Values are only set for fields requested explicitly in the request's search query.",
+"id": "ProductPerformanceView",
+"properties": {
+"brand": {
+"description": "Brand of the product. Segment.",
+"type": "string"
+},
+"categoryL1": {
+"description": "[Product category (1st level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment.",
+"type": "string"
+},
+"categoryL2": {
+"description": "[Product category (2nd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment.",
+"type": "string"
+},
+"categoryL3": {
+"description": "[Product category (3rd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment.",
+"type": "string"
+},
+"categoryL4": {
+"description": "[Product category (4th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment.",
+"type": "string"
+},
+"categoryL5": {
+"description": "[Product category (5th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment.",
+"type": "string"
+},
+"clickThroughRate": {
+"description": "Click-through rate - the number of clicks merchant's products receive (clicks) divided by the number of times the products are shown (impressions). Metric.",
+"format": "double",
+"type": "number"
+},
+"clicks": {
+"description": "Number of clicks. Metric.",
+"format": "int64",
+"type": "string"
+},
+"conversionRate": {
+"description": "Number of conversions divided by the number of clicks, reported on the impression date. Metric. Available only for the `FREE` traffic source.",
+"format": "double",
+"type": "number"
+},
+"conversionValue": {
+"$ref": "Price",
+"description": "Value of conversions attributed to the product, reported on the conversion date. Metric. Available only for the `FREE` traffic source."
+},
+"conversions": {
+"description": "Number of conversions attributed to the product, reported on the conversion date. Depending on the attribution model, a conversion might be distributed across multiple clicks, where each click gets its own credit assigned. This metric is a sum of all such credits. Metric. Available only for the `FREE` traffic source.",
+"format": "double",
+"type": "number"
+},
+"customLabel0": {
+"description": "Custom label 0 for custom grouping of products. Segment.",
+"type": "string"
+},
+"customLabel1": {
+"description": "Custom label 1 for custom grouping of products. Segment.",
+"type": "string"
+},
+"customLabel2": {
+"description": "Custom label 2 for custom grouping of products. Segment.",
+"type": "string"
+},
+"customLabel3": {
+"description": "Custom label 3 for custom grouping of products. Segment.",
+"type": "string"
+},
+"customLabel4": {
+"description": "Custom label 4 for custom grouping of products. Segment.",
+"type": "string"
+},
+"customerCountryCode": {
+"description": "Code of the country where the customer is located at the time of the event. Represented in the ISO 3166 format. Segment. If the customer country cannot be determined, a special 'ZZ' code is returned.",
+"type": "string"
+},
+"date": {
+"$ref": "Date",
+"description": "Date in the merchant timezone to which metrics apply. Segment. Condition on `date` is required in the `WHERE` clause."
+},
+"impressions": {
+"description": "Number of times merchant's products are shown. Metric.",
+"format": "int64",
+"type": "string"
+},
+"marketingMethod": {
+"description": "Marketing method to which metrics apply. Segment.",
+"enum": [
+"MARKETING_METHOD_ENUM_UNSPECIFIED",
+"ORGANIC",
+"ADS"
+],
+"enumDescriptions": [
+"Not specified.",
+"Organic marketing.",
+"Ads-based marketing."
+],
+"type": "string"
+},
+"offerId": {
+"description": "Merchant-provided id of the product. Segment.",
+"type": "string"
+},
+"productTypeL1": {
+"description": "[Product type (1st level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment.",
+"type": "string"
+},
+"productTypeL2": {
+"description": "[Product type (2nd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment.",
+"type": "string"
+},
+"productTypeL3": {
+"description": "[Product type (3rd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment.",
+"type": "string"
+},
+"productTypeL4": {
+"description": "[Product type (4th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment.",
+"type": "string"
+},
+"productTypeL5": {
+"description": "[Product type (5th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment.",
+"type": "string"
+},
+"title": {
+"description": "Title of the product. Segment.",
+"type": "string"
+},
+"week": {
+"$ref": "Date",
+"description": "First day of the week (Monday) of the metrics date in the merchant timezone. Segment."
+}
+},
+"type": "object"
+},
+"ProductStatusChangeMessage": {
+"description": "The message that the merchant will receive to notify about product status change event",
+"id": "ProductStatusChangeMessage",
+"properties": {
+"account": {
+"description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`",
+"type": "string"
+},
+"attribute": {
+"description": "The attribute in the resource that changed, in this case it will be always `Status`.",
+"enum": [
+"ATTRIBUTE_UNSPECIFIED",
+"STATUS"
+],
+"enumDescriptions": [
+"Unspecified attribute",
+"Status of the changed entity"
+],
+"type": "string"
+},
+"changes": {
+"description": "A message to describe the change that happened to the product",
+"items": {
+"$ref": "ProductChange"
+},
+"type": "array"
+},
+"eventTime": {
+"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationTime": {
+"description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.",
+"format": "google-datetime",
+"type": "string"
+},
+"managingAccount": {
+"description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`",
+"type": "string"
+},
+"resource": {
+"description": "The product name. Format: `accounts/{account}/products/{product}`",
+"type": "string"
+},
+"resourceId": {
+"description": "The product id.",
+"type": "string"
+},
+"resourceType": {
+"description": "The resource that changed, in this case it will always be `Product`.",
+"enum": [
+"RESOURCE_UNSPECIFIED",
+"PRODUCT"
+],
+"enumDescriptions": [
+"Unspecified resource",
+"Resource type : product"
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductView": {
+"description": "Fields available for query in `product_view` table. Products in the current inventory. Products in this table are the same as in Products sub-API but not all product attributes from Products sub-API are available for query in this table. In contrast to Products sub-API, this table allows to filter the returned list of products by product attributes. To retrieve a single product by `id` or list all products, Products sub-API should be used. Values are only set for fields requested explicitly in the request's search query. ",
+"id": "ProductView",
+"properties": {
+"aggregatedReportingContextStatus": {
+"description": "Aggregated status.",
+"enum": [
+"AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED",
+"NOT_ELIGIBLE_OR_DISAPPROVED",
+"PENDING",
+"ELIGIBLE_LIMITED",
+"ELIGIBLE"
+],
+"enumDescriptions": [
+"Not specified.",
+"Product is not eligible or is disapproved for all reporting contexts.",
+"Product's status is pending in all reporting contexts.",
+"Product is eligible for some (but not all) reporting contexts.",
+"Product is eligible for all reporting contexts."
+],
+"type": "string"
+},
+"availability": {
+"description": "[Availability](https://support.google.com/merchants/answer/6324448) of the product.",
+"type": "string"
+},
+"brand": {
+"description": "Brand of the product.",
+"type": "string"
+},
+"categoryL1": {
+"description": "Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL2": {
+"description": "Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL3": {
+"description": "Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL4": {
+"description": "Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"categoryL5": {
+"description": "Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).",
+"type": "string"
+},
+"channel": {
+"description": "Channel of the product. Can be `ONLINE` or `LOCAL`.",
+"enum": [
+"CHANNEL_ENUM_UNSPECIFIED",
+"ONLINE",
+"LOCAL"
+],
+"enumDescriptions": [
+"Not specified.",
+"Online product.",
+"Local product."
+],
+"type": "string"
+},
+"clickPotential": {
+"description": "Estimated performance potential compared to highest performing products of the merchant.",
+"enum": [
+"CLICK_POTENTIAL_UNSPECIFIED",
+"LOW",
+"MEDIUM",
+"HIGH"
+],
+"enumDescriptions": [
+"Unknown predicted clicks impact.",
+"Potential to receive a low number of clicks compared to the highest performing products of the merchant.",
+"Potential to receive a moderate number of clicks compared to the highest performing products of the merchant.",
+"Potential to receive a similar number of clicks as the highest performing products of the merchant."
+],
+"type": "string"
+},
+"clickPotentialRank": {
+"description": "Rank of the product based on its click potential. A product with `click_potential_rank` 1 has the highest click potential among the merchant's products that fulfill the search query conditions.",
+"format": "int64",
+"type": "string"
+},
+"condition": {
+"description": "[Condition](https://support.google.com/merchants/answer/6324469) of the product.",
+"type": "string"
+},
+"creationTime": {
+"description": "The time the merchant created the product in timestamp seconds.",
+"format": "google-datetime",
+"type": "string"
+},
+"expirationDate": {
+"$ref": "Date",
+"description": "Expiration date for the product, specified on insertion."
+},
+"feedLabel": {
+"description": "Feed label of the product.",
+"type": "string"
+},
+"gtin": {
+"description": "List of Global Trade Item Numbers (GTINs) of the product.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"id": {
+"description": "REST ID of the product, in the form of `channel~languageCode~feedLabel~offerId`. Merchant API methods that operate on products take this as their `name` parameter. Required in the `SELECT` clause.",
+"type": "string"
+},
+"itemGroupId": {
+"description": "Item group id provided by the merchant for grouping variants together.",
+"type": "string"
+},
+"itemIssues": {
+"description": "List of item issues for the product. **This field cannot be used for sorting the results.** **Only selected attributes of this field (for example, `item_issues.severity.aggregated_severity`) can be used for filtering the results.**",
+"items": {
+"$ref": "ItemIssue"
+},
+"type": "array"
+},
+"languageCode": {
+"description": "Language code of the product in BCP 47 format.",
+"type": "string"
+},
+"offerId": {
+"description": "Merchant-provided id of the product.",
+"type": "string"
+},
+"price": {
+"$ref": "Price",
+"description": "Product price. Absent if the information about the price of the product is not available."
+},
+"productTypeL1": {
+"description": "Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL2": {
+"description": "Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL3": {
+"description": "Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL4": {
+"description": "Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"productTypeL5": {
+"description": "Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406).",
+"type": "string"
+},
+"shippingLabel": {
+"description": "Normalized [shipping label](https://support.google.com/merchants/answer/6324504) specified in the data source.",
+"type": "string"
+},
+"thumbnailLink": {
+"description": "Link to the processed image of the product, hosted on the Google infrastructure.",
+"type": "string"
+},
+"title": {
+"description": "Title of the product.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"ReportRow": {
+"description": "Result row returned from the search query. Only the message corresponding to the queried table is populated in the response. Within the populated message, only the fields requested explicitly in the query are populated.",
+"id": "ReportRow",
+"properties": {
+"bestSellersBrandView": {
+"$ref": "BestSellersBrandView",
+"description": "Fields available for query in `best_sellers_brand_view` table."
+},
+"bestSellersProductClusterView": {
+"$ref": "BestSellersProductClusterView",
+"description": "Fields available for query in `best_sellers_product_cluster_view` table."
+},
+"competitiveVisibilityBenchmarkView": {
+"$ref": "CompetitiveVisibilityBenchmarkView",
+"description": "Fields available for query in `competitive_visibility_benchmark_view` table."
+},
+"competitiveVisibilityCompetitorView": {
+"$ref": "CompetitiveVisibilityCompetitorView",
+"description": "Fields available for query in `competitive_visibility_competitor_view` table."
+},
+"competitiveVisibilityTopMerchantView": {
+"$ref": "CompetitiveVisibilityTopMerchantView",
+"description": "Fields available for query in `competitive_visibility_top_merchant_view` table."
+},
+"nonProductPerformanceView": {
+"$ref": "NonProductPerformanceView",
+"description": "Fields available for query in `non_product_performance_view` table."
+},
+"priceCompetitivenessProductView": {
+"$ref": "PriceCompetitivenessProductView",
+"description": "Fields available for query in `price_competitiveness_product_view` table."
+},
+"priceInsightsProductView": {
+"$ref": "PriceInsightsProductView",
+"description": "Fields available for query in `price_insights_product_view` table."
+},
+"productPerformanceView": {
+"$ref": "ProductPerformanceView",
+"description": "Fields available for query in `product_performance_view` table."
+},
+"productView": {
+"$ref": "ProductView",
+"description": "Fields available for query in `product_view` table."
+}
+},
+"type": "object"
+},
+"SearchRequest": {
+"description": "Request message for the `ReportService.Search` method.",
+"id": "SearchRequest",
+"properties": {
+"pageSize": {
+"description": "Optional. Number of `ReportRows` to retrieve in a single page. Defaults to 1000. Values above 5000 are coerced to 5000.",
+"format": "int32",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. Token of the page to retrieve. If not specified, the first page of results is returned. In order to request the next page of results, the value obtained from `next_page_token` in the previous response should be used.",
+"type": "string"
+},
+"query": {
+"description": "Required. Query that defines a report to be retrieved. For details on how to construct your query, see the [Query Language guide](/merchant/api/guides/reports/query-language). For the full list of available tables and fields, see the [Available fields](/merchant/api/reference/rest/reports_v1beta/accounts.reports).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"SearchResponse": {
+"description": "Response message for the `ReportService.Search` method.",
+"id": "SearchResponse",
+"properties": {
+"nextPageToken": {
+"description": "Token which can be sent as `page_token` to retrieve the next page. If omitted, there are no subsequent pages.",
+"type": "string"
+},
+"results": {
+"description": "Rows that matched the search query.",
+"items": {
+"$ref": "ReportRow"
+},
+"type": "array"
+}
+},
+"type": "object"
+}
+},
+"servicePath": "",
+"title": "Merchant API",
+"version": "reports_v1",
+"version_module": true
+}
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.reports_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.reports_v1beta.json
index 28a321c7a7b..6314a2fcc30 100644
--- a/googleapiclient/discovery_cache/documents/merchantapi.reports_v1beta.json
+++ b/googleapiclient/discovery_cache/documents/merchantapi.reports_v1beta.json
@@ -142,7 +142,7 @@
 }
 }
 },
-"revision": "20250621",
+"revision": "20250808",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "BestSellersBrandView": {
@@ -1518,7 +1518,7 @@ false
 "type": "string"
 },
 "query": {
-"description": "Required. Query that defines a report to be retrieved. For details on how to construct your query, see the [Query Language guide](/merchant/api/guides/reports/query-language). For the full list of available tables and fields, see the [Available fields](/merchant/api/reference/rest/reports_v1beta/accounts.reports).",
+"description": "Required. Query that defines a report to be retrieved. For details on how to construct your query, see the [Query Language guide](/merchant/api/guides/reports/query-language). For the full list of available tables and fields, see the [Available fields](/merchant/api/reference/rest/reports_{api_version}/accounts.reports).",
 "type": "string"
 }
 },

From 9af0269bbcf95a967463f1714e885c766feb7a6c Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:00 +0000
Subject: [PATCH 25/32] feat(mybusinessverifications): update the api

#### mybusinessverifications:v1

The following keys were added:
- schemas.VerifyLocationRequest.properties.trustedPartnerToken.type (Total Keys: 1)
---
 .../mybusinessverifications_v1.locations.html |  1 +
 .../documents/mybusinessverifications.v1.json | 24 +++++++++++++------
 2 files changed, 18 insertions(+), 7 deletions(-)

diff --git a/docs/dyn/mybusinessverifications_v1.locations.html b/docs/dyn/mybusinessverifications_v1.locations.html
index bdaedd5e915..cd362dde837 100644
--- a/docs/dyn/mybusinessverifications_v1.locations.html
+++ b/docs/dyn/mybusinessverifications_v1.locations.html
@@ -241,6 +241,7 @@ 
Method Details

   "token": { # Token generated by a vetted [partner](https://support.google.com/business/answer/7674102). # Optional. The input for VETTED_PARTNER method available to select [partners.](https://support.google.com/business/answer/7674102) The input is not needed for a vetted account. Token that is associated to the location. Token that is associated to the location.
     "tokenString": "A String", # The token string.
   },
+  "trustedPartnerToken": "A String", # The input for TRUSTED_PARTNER method The verification token that is associated to the location.
 }
 
   x__xgafv: string, V1 error format.
diff --git a/googleapiclient/discovery_cache/documents/mybusinessverifications.v1.json b/googleapiclient/discovery_cache/documents/mybusinessverifications.v1.json
index 9b66ad31052..d3ae4f28548 100644
--- a/googleapiclient/discovery_cache/documents/mybusinessverifications.v1.json
+++ b/googleapiclient/discovery_cache/documents/mybusinessverifications.v1.json
@@ -256,7 +256,7 @@
 }
 }
 },
-"revision": "20250721",
+"revision": "20250804",
 "rootUrl": "https://mybusinessverifications.googleapis.com/",
 "schemas": {
 "AddressVerificationData": {
@@ -541,7 +541,8 @@
 "PHONE_CALL",
 "SMS",
 "AUTO",
-"VETTED_PARTNER"
+"VETTED_PARTNER",
+"TRUSTED_PARTNER"
 ],
 "enumDescriptions": [
 "Default value, will result in errors.",
@@ -550,7 +551,8 @@
 "Make a phone call with a verification PIN to a specific phone number. The PIN is used to complete verification with Google.",
 "Send an SMS with a verification PIN to a specific phone number. The PIN is used to complete verification with Google.",
 "Verify the location without additional user action. This option may not be available for all locations.",
-"This option may not be available for all locations."
+"This option may not be available for all locations.",
+"Verify the location via a trusted partner."
 ],
 "type": "string"
 },
@@ -606,7 +608,8 @@
 "PHONE_CALL",
 "SMS",
 "AUTO",
-"VETTED_PARTNER"
+"VETTED_PARTNER",
+"TRUSTED_PARTNER"
 ],
 "enumDescriptions": [
 "Default value, will result in errors.",
@@ -615,7 +618,8 @@
 "Make a phone call with a verification PIN to a specific phone number. The PIN is used to complete verification with Google.",
 "Send an SMS with a verification PIN to a specific phone number. The PIN is used to complete verification with Google.",
 "Verify the location without additional user action. This option may not be available for all locations.",
-"This option may not be available for all locations."
+"This option may not be available for all locations.",
+"Verify the location via a trusted partner."
 ],
 "type": "string"
 }
@@ -673,7 +677,8 @@
 "PHONE_CALL",
 "SMS",
 "AUTO",
-"VETTED_PARTNER"
+"VETTED_PARTNER",
+"TRUSTED_PARTNER"
 ],
 "enumDescriptions": [
 "Default value, will result in errors.",
@@ -682,7 +687,8 @@
 "Make a phone call with a verification PIN to a specific phone number. The PIN is used to complete verification with Google.",
 "Send an SMS with a verification PIN to a specific phone number. The PIN is used to complete verification with Google.",
 "Verify the location without additional user action. This option may not be available for all locations.",
-"This option may not be available for all locations."
+"This option may not be available for all locations.",
+"Verify the location via a trusted partner."
 ],
 "type": "string"
 },
@@ -693,6 +699,10 @@
 "token": {
 "$ref": "VerificationToken",
 "description": "Optional. The input for VETTED_PARTNER method available to select [partners.](https://support.google.com/business/answer/7674102) The input is not needed for a vetted account. Token that is associated to the location. Token that is associated to the location."
+},
+"trustedPartnerToken": {
+"description": "The input for TRUSTED_PARTNER method The verification token that is associated to the location.",
+"type": "string"
 }
 },
 "type": "object"

From 9ba3d7eb9666e91931c3ef40522e3b864bddffeb Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:00 +0000
Subject: [PATCH 26/32] feat(networkservices): update the api

#### networkservices:v1beta1

The following keys were added:
- resources.projects.resources.locations.resources.lbTcpExtensions.methods.create (Total Keys: 16)
- resources.projects.resources.locations.resources.lbTcpExtensions.methods.delete (Total Keys: 13)
- resources.projects.resources.locations.resources.lbTcpExtensions.methods.get (Total Keys: 11)
- resources.projects.resources.locations.resources.lbTcpExtensions.methods.list (Total Keys: 20)
- resources.projects.resources.locations.resources.lbTcpExtensions.methods.patch (Total Keys: 17)
- schemas.LbTcpExtension (Total Keys: 16)
- schemas.ListLbTcpExtensionsResponse (Total Keys: 7)
---
 ...rkservices_v1beta1.projects.locations.html |   5 +
 ...a1.projects.locations.lbTcpExtensions.html | 448 ++++++++++++++++++
 .../documents/networkservices.v1beta1.json    | 271 ++++++++++-
 3 files changed, 723 insertions(+), 1 deletion(-)
 create mode 100644 docs/dyn/networkservices_v1beta1.projects.locations.lbTcpExtensions.html

diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.html b/docs/dyn/networkservices_v1beta1.projects.locations.html
index f3608507b7c..d6c84959644 100644
--- a/docs/dyn/networkservices_v1beta1.projects.locations.html
+++ b/docs/dyn/networkservices_v1beta1.projects.locations.html
@@ -109,6 +109,11 @@ 
Instance Methods

 

 
Returns the lbRouteExtensions Resource.

 
+

+  lbTcpExtensions()
+

+
Returns the lbTcpExtensions Resource.

+
 

   lbTrafficExtensions()
 

diff --git a/docs/dyn/networkservices_v1beta1.projects.locations.lbTcpExtensions.html b/docs/dyn/networkservices_v1beta1.projects.locations.lbTcpExtensions.html
new file mode 100644
index 00000000000..94223276b83
--- /dev/null
+++ b/docs/dyn/networkservices_v1beta1.projects.locations.lbTcpExtensions.html
@@ -0,0 +1,448 @@
+
+
+
+
Network Services API . projects . locations . lbTcpExtensions

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  create(parent, body=None, lbTcpExtensionId=None, requestId=None, x__xgafv=None)

+
Creates a new `LbTcpExtension` resource in a given project and location.

+

+  delete(name, requestId=None, x__xgafv=None)

+
Deletes the specified `LbTcpExtension` resource.

+

+  get(name, x__xgafv=None)

+
Gets details of the specified `LbTcpExtension` resource.

+

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

+
Lists `LbTcpExtension` resources in a given project and location.

+

+  list_next()

+
Retrieves the next page of results.

+

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

+
Updates the parameters of the specified `LbTcpExtension` resource.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, lbTcpExtensionId=None, requestId=None, x__xgafv=None)
+  
Creates a new `LbTcpExtension` resource in a given project and location.
+
+Args:
+  parent: string, Required. The parent resource of the `LbTcpExtension` resource. Must be in the format `projects/{project}/locations/{location}`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # `LbTcpExtension` is a resource that allows traffic forwarding to different backend services to make allow/deny decisions on TCP connections for all L7 Load Balancers within a network. Currently only internal load-balancers are supported.
+  "createTime": "A String", # Output only. The timestamp when the resource was created.
+  "description": "A String", # Optional. A human-readable description of the resource.
+  "extensionChains": [ # Required. A set of ordered extension chains that contain the match conditions and extensions to execute. Match conditions for each extension chain are evaluated in sequence for a given request. The first extension chain that has a condition that matches the request is executed. Any subsequent extension chains do not execute. Limited to 5 extension chains per resource.
+    { # A single extension chain wrapper that contains the match conditions and extensions to execute.
+      "extensions": [ # Required. A set of extensions to execute for the matching request. At least one extension is required. Up to 3 extensions can be defined for each extension chain for `LbTrafficExtension` resource. `LbRouteExtension` and `LbEdgeExtension` chains are limited to 1 extension per extension chain.
+        { # A single extension in the chain to execute for the matching request.
+          "allowDynamicForwarding": True or False, # Optional. When set to `TRUE`, the response from an extension service is allowed to set the `com.google.envoy.dynamic_forwarding` namespace in the dynamic metadata. This field is not supported for plugin extensions. Setting it results in a validation error.
+          "authority": "A String", # Optional. The `:authority` header in the gRPC request sent from Envoy to the extension service. Required for Callout extensions. This field is not supported for plugin extensions. Setting it results in a validation error.
+          "failOpen": True or False, # Optional. Determines how the proxy behaves if the call to the extension fails or times out. When set to `TRUE`, request or response processing continues without error. Any subsequent extensions in the extension chain are also executed. When set to `FALSE` or the default setting of `FALSE` is used, one of the following happens: * If response headers have not been delivered to the downstream client, a generic 500 error is returned to the client. The error response can be tailored by configuring a custom error response in the load balancer. * If response headers have been delivered, then the HTTP stream to the downstream client is reset.
+          "forwardHeaders": [ # Optional. List of the HTTP headers to forward to the extension (from the client or backend). If omitted, all headers are sent. Each element is a string indicating the header name.
+            "A String",
+          ],
+          "metadata": { # Optional. The metadata provided here is included as part of the `metadata_context` (of type `google.protobuf.Struct`) in the `ProcessingRequest` message sent to the extension server. The metadata is available under the namespace `com.google....`. For example: `com.google.lb_traffic_extension.lbtrafficextension1.chain1.ext1`. The following variables are supported in the metadata: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name. This field must not be set for plugin extensions. Setting it results in a validation error. You can set metadata at either the resource level or the extension level. The extension level metadata is recommended because you can pass a different set of metadata through each extension to the backend. This field is subject to following limitations: * The total size of the metadata must be less than 1KiB. * The total number of keys in the metadata must be less than 16. * The length of each key must be less than 64 characters. * The length of each value must be less than 1024 characters. * All values must be strings.
+            "a_key": "", # Properties of the object.
+          },
+          "name": "A String", # Required. The name for this extension. The name is logged as part of the HTTP request logs. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.
+          "requestBodySendMode": "A String", # Optional. Configures the send mode for request body processing. The field can only be set if `supported_events` includes `REQUEST_BODY`. If `supported_events` includes `REQUEST_BODY`, but `request_body_send_mode` is unset, the default value `STREAMED` is used. When this field is set to `FULL_DUPLEX_STREAMED`, `supported_events` must include both `REQUEST_BODY` and `REQUEST_TRAILERS`. This field can be set only for `LbTrafficExtension` and `LbRouteExtension` resources, and only when the `service` field of the extension points to a `BackendService`. Only `FULL_DUPLEX_STREAMED` mode is supported for `LbRouteExtension` resources.
+          "responseBodySendMode": "A String", # Optional. Configures the send mode for response processing. If unspecified, the default value `STREAMED` is used. When this field is set to `FULL_DUPLEX_STREAMED`, `supported_events` must include both `RESPONSE_BODY` and `RESPONSE_TRAILERS`. This field can be set only for `LbTrafficExtension` resources, and only when the `service` field of the extension points to a `BackendService`.
+          "service": "A String", # Required. The reference to the service that runs the extension. To configure a callout extension, `service` must be a fully-qualified reference to a [backend service](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) in the format: `https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/backendServices/{backendService}` or `https://www.googleapis.com/compute/v1/projects/{project}/global/backendServices/{backendService}`. To configure a plugin extension, `service` must be a reference to a [`WasmPlugin` resource](https://cloud.google.com/service-extensions/docs/reference/rest/v1beta1/projects.locations.wasmPlugins) in the format: `projects/{project}/locations/{location}/wasmPlugins/{plugin}` or `//networkservices.googleapis.com/projects/{project}/locations/{location}/wasmPlugins/{wasmPlugin}`. Plugin extensions are currently supported for the `LbTrafficExtension`, the `LbRouteExtension`, and the `LbEdgeExtension` resources.
+          "supportedEvents": [ # Optional. A set of events during request or response processing for which this extension is called. For the `LbTrafficExtension` resource, this field is required. For the `LbRouteExtension` resource, this field is optional. If unspecified, `REQUEST_HEADERS` event is assumed as supported. For the `LbEdgeExtension` resource, this field is required and must only contain `REQUEST_HEADERS` event.
+            "A String",
+          ],
+          "timeout": "A String", # Optional. Specifies the timeout for each individual message on the stream. The timeout must be between `10`-`10000` milliseconds. Required for callout extensions. This field is not supported for plugin extensions. Setting it results in a validation error.
+        },
+      ],
+      "matchCondition": { # Conditions under which this chain is invoked for a request. # Required. Conditions under which this chain is invoked for a request.
+        "celExpression": "A String", # Required. A Common Expression Language (CEL) expression that is used to match requests for which the extension chain is executed. For more information, see [CEL matcher language reference](https://cloud.google.com/service-extensions/docs/cel-matcher-language-reference).
+      },
+      "name": "A String", # Required. The name for this extension chain. The name is logged as part of the HTTP request logs. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.
+    },
+  ],
+  "labels": { # Optional. Set of labels associated with the `LbTcpExtension` resource. The format must comply with [the requirements for labels](/compute/docs/labeling-resources#requirements) for Google Cloud resources.
+    "a_key": "A String",
+  },
+  "loadBalancingScheme": "A String", # Required. All backend services and forwarding rules referenced by this extension must share the same load balancing scheme. Supported values: `INTERNAL_MANAGED`. For more information, refer to [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service).
+  "name": "A String", # Required. Identifier. Name of the `LbTcpExtension` resource in the following format: `projects/{project}/locations/{location}/LbTcpExtension/{lb_tcp_extension}`
+  "networks": [ # Optional. If set, this `LbTcpExtension` resource applies to all `ForwardingRule` resources in these VPC networks. Values should be relative resource names identifying VPC networks, for example `projects/*/global/networks/network-1`. Currently limited to 1 network per resource. Limited to 1 network per resource.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The timestamp when the resource was updated.
+}
+
+  lbTcpExtensionId: string, Required. User-provided ID of the `LbTcpExtension` resource to be created.
+  requestId: string, Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+  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.
+  },
+}

+

+
+

+    delete(name, requestId=None, x__xgafv=None)
+  
Deletes the specified `LbTcpExtension` resource.
+
+Args:
+  name: string, Required. The name of the `LbTcpExtension` resource to delete. Must be in the format `projects/{project}/locations/{location}/LbTcpExtensions/{lb_tcp_extension}`. (required)
+  requestId: string, Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+  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.
+  },
+}

+

+
+

+    get(name, x__xgafv=None)
+  
Gets details of the specified `LbTcpExtension` resource.
+
+Args:
+  name: string, Required. A name of the `LbTcpExtension` resource to get. Must be in the format `projects/{project}/locations/{location}/LbTcpExtensions/{lb_tcp_extension}`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # `LbTcpExtension` is a resource that allows traffic forwarding to different backend services to make allow/deny decisions on TCP connections for all L7 Load Balancers within a network. Currently only internal load-balancers are supported.
+  "createTime": "A String", # Output only. The timestamp when the resource was created.
+  "description": "A String", # Optional. A human-readable description of the resource.
+  "extensionChains": [ # Required. A set of ordered extension chains that contain the match conditions and extensions to execute. Match conditions for each extension chain are evaluated in sequence for a given request. The first extension chain that has a condition that matches the request is executed. Any subsequent extension chains do not execute. Limited to 5 extension chains per resource.
+    { # A single extension chain wrapper that contains the match conditions and extensions to execute.
+      "extensions": [ # Required. A set of extensions to execute for the matching request. At least one extension is required. Up to 3 extensions can be defined for each extension chain for `LbTrafficExtension` resource. `LbRouteExtension` and `LbEdgeExtension` chains are limited to 1 extension per extension chain.
+        { # A single extension in the chain to execute for the matching request.
+          "allowDynamicForwarding": True or False, # Optional. When set to `TRUE`, the response from an extension service is allowed to set the `com.google.envoy.dynamic_forwarding` namespace in the dynamic metadata. This field is not supported for plugin extensions. Setting it results in a validation error.
+          "authority": "A String", # Optional. The `:authority` header in the gRPC request sent from Envoy to the extension service. Required for Callout extensions. This field is not supported for plugin extensions. Setting it results in a validation error.
+          "failOpen": True or False, # Optional. Determines how the proxy behaves if the call to the extension fails or times out. When set to `TRUE`, request or response processing continues without error. Any subsequent extensions in the extension chain are also executed. When set to `FALSE` or the default setting of `FALSE` is used, one of the following happens: * If response headers have not been delivered to the downstream client, a generic 500 error is returned to the client. The error response can be tailored by configuring a custom error response in the load balancer. * If response headers have been delivered, then the HTTP stream to the downstream client is reset.
+          "forwardHeaders": [ # Optional. List of the HTTP headers to forward to the extension (from the client or backend). If omitted, all headers are sent. Each element is a string indicating the header name.
+            "A String",
+          ],
+          "metadata": { # Optional. The metadata provided here is included as part of the `metadata_context` (of type `google.protobuf.Struct`) in the `ProcessingRequest` message sent to the extension server. The metadata is available under the namespace `com.google....`. For example: `com.google.lb_traffic_extension.lbtrafficextension1.chain1.ext1`. The following variables are supported in the metadata: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name. This field must not be set for plugin extensions. Setting it results in a validation error. You can set metadata at either the resource level or the extension level. The extension level metadata is recommended because you can pass a different set of metadata through each extension to the backend. This field is subject to following limitations: * The total size of the metadata must be less than 1KiB. * The total number of keys in the metadata must be less than 16. * The length of each key must be less than 64 characters. * The length of each value must be less than 1024 characters. * All values must be strings.
+            "a_key": "", # Properties of the object.
+          },
+          "name": "A String", # Required. The name for this extension. The name is logged as part of the HTTP request logs. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.
+          "requestBodySendMode": "A String", # Optional. Configures the send mode for request body processing. The field can only be set if `supported_events` includes `REQUEST_BODY`. If `supported_events` includes `REQUEST_BODY`, but `request_body_send_mode` is unset, the default value `STREAMED` is used. When this field is set to `FULL_DUPLEX_STREAMED`, `supported_events` must include both `REQUEST_BODY` and `REQUEST_TRAILERS`. This field can be set only for `LbTrafficExtension` and `LbRouteExtension` resources, and only when the `service` field of the extension points to a `BackendService`. Only `FULL_DUPLEX_STREAMED` mode is supported for `LbRouteExtension` resources.
+          "responseBodySendMode": "A String", # Optional. Configures the send mode for response processing. If unspecified, the default value `STREAMED` is used. When this field is set to `FULL_DUPLEX_STREAMED`, `supported_events` must include both `RESPONSE_BODY` and `RESPONSE_TRAILERS`. This field can be set only for `LbTrafficExtension` resources, and only when the `service` field of the extension points to a `BackendService`.
+          "service": "A String", # Required. The reference to the service that runs the extension. To configure a callout extension, `service` must be a fully-qualified reference to a [backend service](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) in the format: `https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/backendServices/{backendService}` or `https://www.googleapis.com/compute/v1/projects/{project}/global/backendServices/{backendService}`. To configure a plugin extension, `service` must be a reference to a [`WasmPlugin` resource](https://cloud.google.com/service-extensions/docs/reference/rest/v1beta1/projects.locations.wasmPlugins) in the format: `projects/{project}/locations/{location}/wasmPlugins/{plugin}` or `//networkservices.googleapis.com/projects/{project}/locations/{location}/wasmPlugins/{wasmPlugin}`. Plugin extensions are currently supported for the `LbTrafficExtension`, the `LbRouteExtension`, and the `LbEdgeExtension` resources.
+          "supportedEvents": [ # Optional. A set of events during request or response processing for which this extension is called. For the `LbTrafficExtension` resource, this field is required. For the `LbRouteExtension` resource, this field is optional. If unspecified, `REQUEST_HEADERS` event is assumed as supported. For the `LbEdgeExtension` resource, this field is required and must only contain `REQUEST_HEADERS` event.
+            "A String",
+          ],
+          "timeout": "A String", # Optional. Specifies the timeout for each individual message on the stream. The timeout must be between `10`-`10000` milliseconds. Required for callout extensions. This field is not supported for plugin extensions. Setting it results in a validation error.
+        },
+      ],
+      "matchCondition": { # Conditions under which this chain is invoked for a request. # Required. Conditions under which this chain is invoked for a request.
+        "celExpression": "A String", # Required. A Common Expression Language (CEL) expression that is used to match requests for which the extension chain is executed. For more information, see [CEL matcher language reference](https://cloud.google.com/service-extensions/docs/cel-matcher-language-reference).
+      },
+      "name": "A String", # Required. The name for this extension chain. The name is logged as part of the HTTP request logs. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.
+    },
+  ],
+  "labels": { # Optional. Set of labels associated with the `LbTcpExtension` resource. The format must comply with [the requirements for labels](/compute/docs/labeling-resources#requirements) for Google Cloud resources.
+    "a_key": "A String",
+  },
+  "loadBalancingScheme": "A String", # Required. All backend services and forwarding rules referenced by this extension must share the same load balancing scheme. Supported values: `INTERNAL_MANAGED`. For more information, refer to [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service).
+  "name": "A String", # Required. Identifier. Name of the `LbTcpExtension` resource in the following format: `projects/{project}/locations/{location}/LbTcpExtension/{lb_tcp_extension}`
+  "networks": [ # Optional. If set, this `LbTcpExtension` resource applies to all `ForwardingRule` resources in these VPC networks. Values should be relative resource names identifying VPC networks, for example `projects/*/global/networks/network-1`. Currently limited to 1 network per resource. Limited to 1 network per resource.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The timestamp when the resource was updated.
+}

+

+
+

+    list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists `LbTcpExtension` resources in a given project and location.
+
+Args:
+  parent: string, Required. The project and location from which the `LbTcpExtension` resources are listed, specified in the following format: `projects/{project}/locations/{location}`. (required)
+  filter: string, Optional. Filtering results.
+  orderBy: string, Optional. Hint for how to order the results.
+  pageSize: integer, Optional. Requested page size. The server might return fewer items than requested. If unspecified, the server picks an appropriate default.
+  pageToken: string, Optional. A token identifying a page of results that the server returns.
+  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 `LbTcpExtension` resources.
+  "lbTcpExtensions": [ # The list of `LbTcpExtension` resources.
+    { # `LbTcpExtension` is a resource that allows traffic forwarding to different backend services to make allow/deny decisions on TCP connections for all L7 Load Balancers within a network. Currently only internal load-balancers are supported.
+      "createTime": "A String", # Output only. The timestamp when the resource was created.
+      "description": "A String", # Optional. A human-readable description of the resource.
+      "extensionChains": [ # Required. A set of ordered extension chains that contain the match conditions and extensions to execute. Match conditions for each extension chain are evaluated in sequence for a given request. The first extension chain that has a condition that matches the request is executed. Any subsequent extension chains do not execute. Limited to 5 extension chains per resource.
+        { # A single extension chain wrapper that contains the match conditions and extensions to execute.
+          "extensions": [ # Required. A set of extensions to execute for the matching request. At least one extension is required. Up to 3 extensions can be defined for each extension chain for `LbTrafficExtension` resource. `LbRouteExtension` and `LbEdgeExtension` chains are limited to 1 extension per extension chain.
+            { # A single extension in the chain to execute for the matching request.
+              "allowDynamicForwarding": True or False, # Optional. When set to `TRUE`, the response from an extension service is allowed to set the `com.google.envoy.dynamic_forwarding` namespace in the dynamic metadata. This field is not supported for plugin extensions. Setting it results in a validation error.
+              "authority": "A String", # Optional. The `:authority` header in the gRPC request sent from Envoy to the extension service. Required for Callout extensions. This field is not supported for plugin extensions. Setting it results in a validation error.
+              "failOpen": True or False, # Optional. Determines how the proxy behaves if the call to the extension fails or times out. When set to `TRUE`, request or response processing continues without error. Any subsequent extensions in the extension chain are also executed. When set to `FALSE` or the default setting of `FALSE` is used, one of the following happens: * If response headers have not been delivered to the downstream client, a generic 500 error is returned to the client. The error response can be tailored by configuring a custom error response in the load balancer. * If response headers have been delivered, then the HTTP stream to the downstream client is reset.
+              "forwardHeaders": [ # Optional. List of the HTTP headers to forward to the extension (from the client or backend). If omitted, all headers are sent. Each element is a string indicating the header name.
+                "A String",
+              ],
+              "metadata": { # Optional. The metadata provided here is included as part of the `metadata_context` (of type `google.protobuf.Struct`) in the `ProcessingRequest` message sent to the extension server. The metadata is available under the namespace `com.google....`. For example: `com.google.lb_traffic_extension.lbtrafficextension1.chain1.ext1`. The following variables are supported in the metadata: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name. This field must not be set for plugin extensions. Setting it results in a validation error. You can set metadata at either the resource level or the extension level. The extension level metadata is recommended because you can pass a different set of metadata through each extension to the backend. This field is subject to following limitations: * The total size of the metadata must be less than 1KiB. * The total number of keys in the metadata must be less than 16. * The length of each key must be less than 64 characters. * The length of each value must be less than 1024 characters. * All values must be strings.
+                "a_key": "", # Properties of the object.
+              },
+              "name": "A String", # Required. The name for this extension. The name is logged as part of the HTTP request logs. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.
+              "requestBodySendMode": "A String", # Optional. Configures the send mode for request body processing. The field can only be set if `supported_events` includes `REQUEST_BODY`. If `supported_events` includes `REQUEST_BODY`, but `request_body_send_mode` is unset, the default value `STREAMED` is used. When this field is set to `FULL_DUPLEX_STREAMED`, `supported_events` must include both `REQUEST_BODY` and `REQUEST_TRAILERS`. This field can be set only for `LbTrafficExtension` and `LbRouteExtension` resources, and only when the `service` field of the extension points to a `BackendService`. Only `FULL_DUPLEX_STREAMED` mode is supported for `LbRouteExtension` resources.
+              "responseBodySendMode": "A String", # Optional. Configures the send mode for response processing. If unspecified, the default value `STREAMED` is used. When this field is set to `FULL_DUPLEX_STREAMED`, `supported_events` must include both `RESPONSE_BODY` and `RESPONSE_TRAILERS`. This field can be set only for `LbTrafficExtension` resources, and only when the `service` field of the extension points to a `BackendService`.
+              "service": "A String", # Required. The reference to the service that runs the extension. To configure a callout extension, `service` must be a fully-qualified reference to a [backend service](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) in the format: `https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/backendServices/{backendService}` or `https://www.googleapis.com/compute/v1/projects/{project}/global/backendServices/{backendService}`. To configure a plugin extension, `service` must be a reference to a [`WasmPlugin` resource](https://cloud.google.com/service-extensions/docs/reference/rest/v1beta1/projects.locations.wasmPlugins) in the format: `projects/{project}/locations/{location}/wasmPlugins/{plugin}` or `//networkservices.googleapis.com/projects/{project}/locations/{location}/wasmPlugins/{wasmPlugin}`. Plugin extensions are currently supported for the `LbTrafficExtension`, the `LbRouteExtension`, and the `LbEdgeExtension` resources.
+              "supportedEvents": [ # Optional. A set of events during request or response processing for which this extension is called. For the `LbTrafficExtension` resource, this field is required. For the `LbRouteExtension` resource, this field is optional. If unspecified, `REQUEST_HEADERS` event is assumed as supported. For the `LbEdgeExtension` resource, this field is required and must only contain `REQUEST_HEADERS` event.
+                "A String",
+              ],
+              "timeout": "A String", # Optional. Specifies the timeout for each individual message on the stream. The timeout must be between `10`-`10000` milliseconds. Required for callout extensions. This field is not supported for plugin extensions. Setting it results in a validation error.
+            },
+          ],
+          "matchCondition": { # Conditions under which this chain is invoked for a request. # Required. Conditions under which this chain is invoked for a request.
+            "celExpression": "A String", # Required. A Common Expression Language (CEL) expression that is used to match requests for which the extension chain is executed. For more information, see [CEL matcher language reference](https://cloud.google.com/service-extensions/docs/cel-matcher-language-reference).
+          },
+          "name": "A String", # Required. The name for this extension chain. The name is logged as part of the HTTP request logs. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.
+        },
+      ],
+      "labels": { # Optional. Set of labels associated with the `LbTcpExtension` resource. The format must comply with [the requirements for labels](/compute/docs/labeling-resources#requirements) for Google Cloud resources.
+        "a_key": "A String",
+      },
+      "loadBalancingScheme": "A String", # Required. All backend services and forwarding rules referenced by this extension must share the same load balancing scheme. Supported values: `INTERNAL_MANAGED`. For more information, refer to [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service).
+      "name": "A String", # Required. Identifier. Name of the `LbTcpExtension` resource in the following format: `projects/{project}/locations/{location}/LbTcpExtension/{lb_tcp_extension}`
+      "networks": [ # Optional. If set, this `LbTcpExtension` resource applies to all `ForwardingRule` resources in these VPC networks. Values should be relative resource names identifying VPC networks, for example `projects/*/global/networks/network-1`. Currently limited to 1 network per resource. Limited to 1 network per resource.
+        "A String",
+      ],
+      "updateTime": "A String", # Output only. The timestamp when the resource was updated.
+    },
+  ],
+  "nextPageToken": "A String", # A token identifying a page of results that the server returns.
+  "unreachable": [ # Locations that could not be reached.
+    "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, requestId=None, updateMask=None, x__xgafv=None)
+  
Updates the parameters of the specified `LbTcpExtension` resource.
+
+Args:
+  name: string, Required. Identifier. Name of the `LbTcpExtension` resource in the following format: `projects/{project}/locations/{location}/LbTcpExtension/{lb_tcp_extension}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # `LbTcpExtension` is a resource that allows traffic forwarding to different backend services to make allow/deny decisions on TCP connections for all L7 Load Balancers within a network. Currently only internal load-balancers are supported.
+  "createTime": "A String", # Output only. The timestamp when the resource was created.
+  "description": "A String", # Optional. A human-readable description of the resource.
+  "extensionChains": [ # Required. A set of ordered extension chains that contain the match conditions and extensions to execute. Match conditions for each extension chain are evaluated in sequence for a given request. The first extension chain that has a condition that matches the request is executed. Any subsequent extension chains do not execute. Limited to 5 extension chains per resource.
+    { # A single extension chain wrapper that contains the match conditions and extensions to execute.
+      "extensions": [ # Required. A set of extensions to execute for the matching request. At least one extension is required. Up to 3 extensions can be defined for each extension chain for `LbTrafficExtension` resource. `LbRouteExtension` and `LbEdgeExtension` chains are limited to 1 extension per extension chain.
+        { # A single extension in the chain to execute for the matching request.
+          "allowDynamicForwarding": True or False, # Optional. When set to `TRUE`, the response from an extension service is allowed to set the `com.google.envoy.dynamic_forwarding` namespace in the dynamic metadata. This field is not supported for plugin extensions. Setting it results in a validation error.
+          "authority": "A String", # Optional. The `:authority` header in the gRPC request sent from Envoy to the extension service. Required for Callout extensions. This field is not supported for plugin extensions. Setting it results in a validation error.
+          "failOpen": True or False, # Optional. Determines how the proxy behaves if the call to the extension fails or times out. When set to `TRUE`, request or response processing continues without error. Any subsequent extensions in the extension chain are also executed. When set to `FALSE` or the default setting of `FALSE` is used, one of the following happens: * If response headers have not been delivered to the downstream client, a generic 500 error is returned to the client. The error response can be tailored by configuring a custom error response in the load balancer. * If response headers have been delivered, then the HTTP stream to the downstream client is reset.
+          "forwardHeaders": [ # Optional. List of the HTTP headers to forward to the extension (from the client or backend). If omitted, all headers are sent. Each element is a string indicating the header name.
+            "A String",
+          ],
+          "metadata": { # Optional. The metadata provided here is included as part of the `metadata_context` (of type `google.protobuf.Struct`) in the `ProcessingRequest` message sent to the extension server. The metadata is available under the namespace `com.google....`. For example: `com.google.lb_traffic_extension.lbtrafficextension1.chain1.ext1`. The following variables are supported in the metadata: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name. This field must not be set for plugin extensions. Setting it results in a validation error. You can set metadata at either the resource level or the extension level. The extension level metadata is recommended because you can pass a different set of metadata through each extension to the backend. This field is subject to following limitations: * The total size of the metadata must be less than 1KiB. * The total number of keys in the metadata must be less than 16. * The length of each key must be less than 64 characters. * The length of each value must be less than 1024 characters. * All values must be strings.
+            "a_key": "", # Properties of the object.
+          },
+          "name": "A String", # Required. The name for this extension. The name is logged as part of the HTTP request logs. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.
+          "requestBodySendMode": "A String", # Optional. Configures the send mode for request body processing. The field can only be set if `supported_events` includes `REQUEST_BODY`. If `supported_events` includes `REQUEST_BODY`, but `request_body_send_mode` is unset, the default value `STREAMED` is used. When this field is set to `FULL_DUPLEX_STREAMED`, `supported_events` must include both `REQUEST_BODY` and `REQUEST_TRAILERS`. This field can be set only for `LbTrafficExtension` and `LbRouteExtension` resources, and only when the `service` field of the extension points to a `BackendService`. Only `FULL_DUPLEX_STREAMED` mode is supported for `LbRouteExtension` resources.
+          "responseBodySendMode": "A String", # Optional. Configures the send mode for response processing. If unspecified, the default value `STREAMED` is used. When this field is set to `FULL_DUPLEX_STREAMED`, `supported_events` must include both `RESPONSE_BODY` and `RESPONSE_TRAILERS`. This field can be set only for `LbTrafficExtension` resources, and only when the `service` field of the extension points to a `BackendService`.
+          "service": "A String", # Required. The reference to the service that runs the extension. To configure a callout extension, `service` must be a fully-qualified reference to a [backend service](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) in the format: `https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/backendServices/{backendService}` or `https://www.googleapis.com/compute/v1/projects/{project}/global/backendServices/{backendService}`. To configure a plugin extension, `service` must be a reference to a [`WasmPlugin` resource](https://cloud.google.com/service-extensions/docs/reference/rest/v1beta1/projects.locations.wasmPlugins) in the format: `projects/{project}/locations/{location}/wasmPlugins/{plugin}` or `//networkservices.googleapis.com/projects/{project}/locations/{location}/wasmPlugins/{wasmPlugin}`. Plugin extensions are currently supported for the `LbTrafficExtension`, the `LbRouteExtension`, and the `LbEdgeExtension` resources.
+          "supportedEvents": [ # Optional. A set of events during request or response processing for which this extension is called. For the `LbTrafficExtension` resource, this field is required. For the `LbRouteExtension` resource, this field is optional. If unspecified, `REQUEST_HEADERS` event is assumed as supported. For the `LbEdgeExtension` resource, this field is required and must only contain `REQUEST_HEADERS` event.
+            "A String",
+          ],
+          "timeout": "A String", # Optional. Specifies the timeout for each individual message on the stream. The timeout must be between `10`-`10000` milliseconds. Required for callout extensions. This field is not supported for plugin extensions. Setting it results in a validation error.
+        },
+      ],
+      "matchCondition": { # Conditions under which this chain is invoked for a request. # Required. Conditions under which this chain is invoked for a request.
+        "celExpression": "A String", # Required. A Common Expression Language (CEL) expression that is used to match requests for which the extension chain is executed. For more information, see [CEL matcher language reference](https://cloud.google.com/service-extensions/docs/cel-matcher-language-reference).
+      },
+      "name": "A String", # Required. The name for this extension chain. The name is logged as part of the HTTP request logs. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.
+    },
+  ],
+  "labels": { # Optional. Set of labels associated with the `LbTcpExtension` resource. The format must comply with [the requirements for labels](/compute/docs/labeling-resources#requirements) for Google Cloud resources.
+    "a_key": "A String",
+  },
+  "loadBalancingScheme": "A String", # Required. All backend services and forwarding rules referenced by this extension must share the same load balancing scheme. Supported values: `INTERNAL_MANAGED`. For more information, refer to [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service).
+  "name": "A String", # Required. Identifier. Name of the `LbTcpExtension` resource in the following format: `projects/{project}/locations/{location}/LbTcpExtension/{lb_tcp_extension}`
+  "networks": [ # Optional. If set, this `LbTcpExtension` resource applies to all `ForwardingRule` resources in these VPC networks. Values should be relative resource names identifying VPC networks, for example `projects/*/global/networks/network-1`. Currently limited to 1 network per resource. Limited to 1 network per resource.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The timestamp when the resource was updated.
+}
+
+  requestId: string, Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+  updateMask: string, Optional. Used to specify the fields to be overwritten in the `LbTcpExtension` resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field is overwritten if it is in the mask. If the user does not specify a mask, then all fields are overwritten.
+  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.
+  },
+}

+

+
+
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/networkservices.v1beta1.json b/googleapiclient/discovery_cache/documents/networkservices.v1beta1.json
index 7396ddf3fe9..9dcb9c71daa 100644
--- a/googleapiclient/discovery_cache/documents/networkservices.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/networkservices.v1beta1.json
@@ -1439,6 +1439,188 @@
 }
 }
 },
+"lbTcpExtensions": {
+"methods": {
+"create": {
+"description": "Creates a new `LbTcpExtension` resource in a given project and location.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/lbTcpExtensions",
+"httpMethod": "POST",
+"id": "networkservices.projects.locations.lbTcpExtensions.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"lbTcpExtensionId": {
+"description": "Required. User-provided ID of the `LbTcpExtension` resource to be created.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent resource of the `LbTcpExtension` resource. Must be in the format `projects/{project}/locations/{location}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+},
+"requestId": {
+"description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1beta1/{+parent}/lbTcpExtensions",
+"request": {
+"$ref": "LbTcpExtension"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"delete": {
+"description": "Deletes the specified `LbTcpExtension` resource.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/lbTcpExtensions/{lbTcpExtensionsId}",
+"httpMethod": "DELETE",
+"id": "networkservices.projects.locations.lbTcpExtensions.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the `LbTcpExtension` resource to delete. Must be in the format `projects/{project}/locations/{location}/LbTcpExtensions/{lb_tcp_extension}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/lbTcpExtensions/[^/]+$",
+"required": true,
+"type": "string"
+},
+"requestId": {
+"description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1beta1/{+name}",
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets details of the specified `LbTcpExtension` resource.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/lbTcpExtensions/{lbTcpExtensionsId}",
+"httpMethod": "GET",
+"id": "networkservices.projects.locations.lbTcpExtensions.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. A name of the `LbTcpExtension` resource to get. Must be in the format `projects/{project}/locations/{location}/LbTcpExtensions/{lb_tcp_extension}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/lbTcpExtensions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta1/{+name}",
+"response": {
+"$ref": "LbTcpExtension"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists `LbTcpExtension` resources in a given project and location.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/lbTcpExtensions",
+"httpMethod": "GET",
+"id": "networkservices.projects.locations.lbTcpExtensions.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"filter": {
+"description": "Optional. Filtering results.",
+"location": "query",
+"type": "string"
+},
+"orderBy": {
+"description": "Optional. Hint for how to order the results.",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Optional. Requested page size. The server might return fewer items than requested. If unspecified, the server picks an appropriate default.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A token identifying a page of results that the server returns.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The project and location from which the `LbTcpExtension` resources are listed, specified in the following format: `projects/{project}/locations/{location}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta1/{+parent}/lbTcpExtensions",
+"response": {
+"$ref": "ListLbTcpExtensionsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates the parameters of the specified `LbTcpExtension` resource.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/lbTcpExtensions/{lbTcpExtensionsId}",
+"httpMethod": "PATCH",
+"id": "networkservices.projects.locations.lbTcpExtensions.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. Identifier. Name of the `LbTcpExtension` resource in the following format: `projects/{project}/locations/{location}/LbTcpExtension/{lb_tcp_extension}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/lbTcpExtensions/[^/]+$",
+"required": true,
+"type": "string"
+},
+"requestId": {
+"description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).",
+"location": "query",
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. Used to specify the fields to be overwritten in the `LbTcpExtension` resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field is overwritten if it is in the mask. If the user does not specify a mask, then all fields are overwritten.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1beta1/{+name}",
+"request": {
+"$ref": "LbTcpExtension"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "lbTrafficExtensions": {
 "methods": {
 "create": {
@@ -2913,7 +3095,7 @@
 }
 }
 },
-"revision": "20250723",
+"revision": "20250730",
 "rootUrl": "https://networkservices.googleapis.com/",
 "schemas": {
 "AuthzExtension": {
@@ -4395,6 +4577,68 @@
 },
 "type": "object"
 },
+"LbTcpExtension": {
+"description": "`LbTcpExtension` is a resource that allows traffic forwarding to different backend services to make allow/deny decisions on TCP connections for all L7 Load Balancers within a network. Currently only internal load-balancers are supported.",
+"id": "LbTcpExtension",
+"properties": {
+"createTime": {
+"description": "Output only. The timestamp when the resource was created.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"description": {
+"description": "Optional. A human-readable description of the resource.",
+"type": "string"
+},
+"extensionChains": {
+"description": "Required. A set of ordered extension chains that contain the match conditions and extensions to execute. Match conditions for each extension chain are evaluated in sequence for a given request. The first extension chain that has a condition that matches the request is executed. Any subsequent extension chains do not execute. Limited to 5 extension chains per resource.",
+"items": {
+"$ref": "ExtensionChain"
+},
+"type": "array"
+},
+"labels": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Optional. Set of labels associated with the `LbTcpExtension` resource. The format must comply with [the requirements for labels](/compute/docs/labeling-resources#requirements) for Google Cloud resources.",
+"type": "object"
+},
+"loadBalancingScheme": {
+"description": "Required. All backend services and forwarding rules referenced by this extension must share the same load balancing scheme. Supported values: `INTERNAL_MANAGED`. For more information, refer to [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service).",
+"enum": [
+"LOAD_BALANCING_SCHEME_UNSPECIFIED",
+"INTERNAL_MANAGED",
+"EXTERNAL_MANAGED"
+],
+"enumDescriptions": [
+"Default value. Do not use.",
+"Signifies that this is used for Internal HTTP(S) Load Balancing.",
+"Signifies that this is used for External Managed HTTP(S) Load Balancing."
+],
+"type": "string"
+},
+"name": {
+"description": "Required. Identifier. Name of the `LbTcpExtension` resource in the following format: `projects/{project}/locations/{location}/LbTcpExtension/{lb_tcp_extension}`",
+"type": "string"
+},
+"networks": {
+"description": "Optional. If set, this `LbTcpExtension` resource applies to all `ForwardingRule` resources in these VPC networks. Values should be relative resource names identifying VPC networks, for example `projects/*/global/networks/network-1`. Currently limited to 1 network per resource. Limited to 1 network per resource.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"updateTime": {
+"description": "Output only. The timestamp when the resource was updated.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "LbTrafficExtension": {
 "description": "`LbTrafficExtension` is a resource that lets the extension service modify the headers and payloads of both requests and responses without impacting the choice of backend services or any other security policies associated with the backend service.",
 "id": "LbTrafficExtension",
@@ -4665,6 +4909,31 @@
 },
 "type": "object"
 },
+"ListLbTcpExtensionsResponse": {
+"description": "Message for response to listing `LbTcpExtension` resources.",
+"id": "ListLbTcpExtensionsResponse",
+"properties": {
+"lbTcpExtensions": {
+"description": "The list of `LbTcpExtension` resources.",
+"items": {
+"$ref": "LbTcpExtension"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "A token identifying a page of results that the server returns.",
+"type": "string"
+},
+"unreachable": {
+"description": "Locations that could not be reached.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "ListLbTrafficExtensionsResponse": {
 "description": "Message for response to listing `LbTrafficExtension` resources.",
 "id": "ListLbTrafficExtensionsResponse",

From 693a5733fd2c1b1474689515e79db8728136000f Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:00 +0000
Subject: [PATCH 27/32] feat(paymentsresellersubscription): update the api

#### paymentsresellersubscription:v1

The following keys were deleted:
- schemas.GoogleCloudPaymentsResellerSubscriptionV1Amount (Total Keys: 5)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1CancelSubscriptionRequest (Total Keys: 4)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1CancelSubscriptionResponse (Total Keys: 3)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1CreateSubscriptionIntent (Total Keys: 5)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1Duration (Total Keys: 5)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1ExtendSubscriptionRequest (Total Keys: 4)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1ExtendSubscriptionResponse (Total Keys: 9)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1Extension (Total Keys: 4)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1FindEligiblePromotionsRequest (Total Keys: 6)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1FindEligiblePromotionsResponse (Total Keys: 5)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1FiniteBillingCycleDetails (Total Keys: 4)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1GenerateUserSessionRequest (Total Keys: 3)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1GenerateUserSessionResponse (Total Keys: 3)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1GoogleHomePayload (Total Keys: 5)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1GoogleOnePayload (Total Keys: 7)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1IntentPayload (Total Keys: 3)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1ListProductsResponse (Total Keys: 5)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1ListPromotionsResponse (Total Keys: 5)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1Location (Total Keys: 4)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1Product (Total Keys: 31)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1Promotion (Total Keys: 34)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1ResumeSubscriptionRequest (Total Keys: 2)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1ResumeSubscriptionResponse (Total Keys: 3)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1ServicePeriod (Total Keys: 6)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1Subscription (Total Keys: 96)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1SuspendSubscriptionRequest (Total Keys: 2)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1SuspendSubscriptionResponse (Total Keys: 3)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1UndoCancelSubscriptionRequest (Total Keys: 2)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1UndoCancelSubscriptionResponse (Total Keys: 3)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1UserSession (Total Keys: 7)
- schemas.GoogleCloudPaymentsResellerSubscriptionV1YoutubePayload (Total Keys: 8)

The following keys were added:
- schemas.Amount (Total Keys: 5)
- schemas.CancelSubscriptionRequest (Total Keys: 4)
- schemas.CancelSubscriptionResponse (Total Keys: 3)
- schemas.CreateSubscriptionIntent (Total Keys: 5)
- schemas.Duration (Total Keys: 5)
- schemas.ExtendSubscriptionRequest (Total Keys: 4)
- schemas.ExtendSubscriptionResponse (Total Keys: 9)
- schemas.Extension (Total Keys: 4)
- schemas.FindEligiblePromotionsRequest (Total Keys: 6)
- schemas.FindEligiblePromotionsResponse (Total Keys: 5)
- schemas.FiniteBillingCycleDetails (Total Keys: 4)
- schemas.GenerateUserSessionRequest (Total Keys: 3)
- schemas.GenerateUserSessionResponse (Total Keys: 3)
- schemas.GoogleHomePayload (Total Keys: 6)
- schemas.GoogleOnePayload (Total Keys: 7)
- schemas.IntentPayload (Total Keys: 3)
- schemas.ListProductsResponse (Total Keys: 5)
- schemas.ListPromotionsResponse (Total Keys: 5)
- schemas.Location (Total Keys: 4)
- schemas.Product (Total Keys: 31)
- schemas.Promotion (Total Keys: 34)
- schemas.ResumeSubscriptionRequest (Total Keys: 2)
- schemas.ResumeSubscriptionResponse (Total Keys: 3)
- schemas.ServicePeriod (Total Keys: 6)
- schemas.Subscription (Total Keys: 96)
- schemas.SuspendSubscriptionRequest (Total Keys: 2)
- schemas.SuspendSubscriptionResponse (Total Keys: 3)
- schemas.UndoCancelSubscriptionRequest (Total Keys: 2)
- schemas.UndoCancelSubscriptionResponse (Total Keys: 3)
- schemas.UserSession (Total Keys: 7)
- schemas.YoutubePayload (Total Keys: 8)

The following keys were changed:
- resources.partners.resources.products.methods.list.response.$ref (Total Keys: 1)
- resources.partners.resources.promotions.methods.findEligible.request.$ref (Total Keys: 1)
- resources.partners.resources.promotions.methods.findEligible.response.$ref (Total Keys: 1)
- resources.partners.resources.promotions.methods.list.response.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.cancel.request.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.cancel.response.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.create.request.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.create.response.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.extend.request.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.extend.response.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.get.response.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.provision.request.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.provision.response.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.resume.request.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.resume.response.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.suspend.request.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.suspend.response.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.undoCancel.request.$ref (Total Keys: 1)
- resources.partners.resources.subscriptions.methods.undoCancel.response.$ref (Total Keys: 1)
- resources.partners.resources.userSessions.methods.generate.request.$ref (Total Keys: 1)
- resources.partners.resources.userSessions.methods.generate.response.$ref (Total Keys: 1)
- schemas.ProductBundleDetails.properties.bundleElements.items.$ref (Total Keys: 1)
- schemas.SubscriptionLineItemBundleDetails.properties.bundleElementDetails.items.$ref (Total Keys: 1)
---
 ...ubscription_v1.partners.subscriptions.html |  10 +
 ...subscription_v1.partners.userSessions.html |   1 +
 .../paymentsresellersubscription.v1.json      | 438 +++++++++---------
 3 files changed, 232 insertions(+), 217 deletions(-)

diff --git a/docs/dyn/paymentsresellersubscription_v1.partners.subscriptions.html b/docs/dyn/paymentsresellersubscription_v1.partners.subscriptions.html
index f05d2877195..b6d01a06c60 100644
--- a/docs/dyn/paymentsresellersubscription_v1.partners.subscriptions.html
+++ b/docs/dyn/paymentsresellersubscription_v1.partners.subscriptions.html
@@ -189,6 +189,7 @@ 
Method Details

         "productPayload": { # Specifies product specific payload. # Optional. Product specific payload for this line item.
           "googleHomePayload": { # Payload specific for Google Home products. # Payload specific to Google Home products.
             "attachedToGoogleStructure": True or False, # Output only. This identifies whether the subscription is attached to a Google Home structure.
+            "googleStructureId": "A String", # Optional. Structure identifier on Google side.
             "partnerStructureId": "A String", # Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.
           },
           "googleOnePayload": { # Payload specific to Google One products. # Product-specific payloads. Payload specific to Google One products.
@@ -338,6 +339,7 @@ 
Method Details

       "productPayload": { # Specifies product specific payload. # Optional. Product specific payload for this line item.
         "googleHomePayload": { # Payload specific for Google Home products. # Payload specific to Google Home products.
           "attachedToGoogleStructure": True or False, # Output only. This identifies whether the subscription is attached to a Google Home structure.
+          "googleStructureId": "A String", # Optional. Structure identifier on Google side.
           "partnerStructureId": "A String", # Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.
         },
         "googleOnePayload": { # Payload specific to Google One products. # Product-specific payloads. Payload specific to Google One products.
@@ -480,6 +482,7 @@ 
Method Details

       "productPayload": { # Specifies product specific payload. # Optional. Product specific payload for this line item.
         "googleHomePayload": { # Payload specific for Google Home products. # Payload specific to Google Home products.
           "attachedToGoogleStructure": True or False, # Output only. This identifies whether the subscription is attached to a Google Home structure.
+          "googleStructureId": "A String", # Optional. Structure identifier on Google side.
           "partnerStructureId": "A String", # Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.
         },
         "googleOnePayload": { # Payload specific to Google One products. # Product-specific payloads. Payload specific to Google One products.
@@ -643,6 +646,7 @@ 
Method Details

         "productPayload": { # Specifies product specific payload. # Optional. Product specific payload for this line item.
           "googleHomePayload": { # Payload specific for Google Home products. # Payload specific to Google Home products.
             "attachedToGoogleStructure": True or False, # Output only. This identifies whether the subscription is attached to a Google Home structure.
+            "googleStructureId": "A String", # Optional. Structure identifier on Google side.
             "partnerStructureId": "A String", # Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.
           },
           "googleOnePayload": { # Payload specific to Google One products. # Product-specific payloads. Payload specific to Google One products.
@@ -827,6 +831,7 @@ 
Method Details

       "productPayload": { # Specifies product specific payload. # Optional. Product specific payload for this line item.
         "googleHomePayload": { # Payload specific for Google Home products. # Payload specific to Google Home products.
           "attachedToGoogleStructure": True or False, # Output only. This identifies whether the subscription is attached to a Google Home structure.
+          "googleStructureId": "A String", # Optional. Structure identifier on Google side.
           "partnerStructureId": "A String", # Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.
         },
         "googleOnePayload": { # Payload specific to Google One products. # Product-specific payloads. Payload specific to Google One products.
@@ -970,6 +975,7 @@ 
Method Details

       "productPayload": { # Specifies product specific payload. # Optional. Product specific payload for this line item.
         "googleHomePayload": { # Payload specific for Google Home products. # Payload specific to Google Home products.
           "attachedToGoogleStructure": True or False, # Output only. This identifies whether the subscription is attached to a Google Home structure.
+          "googleStructureId": "A String", # Optional. Structure identifier on Google side.
           "partnerStructureId": "A String", # Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.
         },
         "googleOnePayload": { # Payload specific to Google One products. # Product-specific payloads. Payload specific to Google One products.
@@ -1112,6 +1118,7 @@ 
Method Details

       "productPayload": { # Specifies product specific payload. # Optional. Product specific payload for this line item.
         "googleHomePayload": { # Payload specific for Google Home products. # Payload specific to Google Home products.
           "attachedToGoogleStructure": True or False, # Output only. This identifies whether the subscription is attached to a Google Home structure.
+          "googleStructureId": "A String", # Optional. Structure identifier on Google side.
           "partnerStructureId": "A String", # Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.
         },
         "googleOnePayload": { # Payload specific to Google One products. # Product-specific payloads. Payload specific to Google One products.
@@ -1267,6 +1274,7 @@ 
Method Details

         "productPayload": { # Specifies product specific payload. # Optional. Product specific payload for this line item.
           "googleHomePayload": { # Payload specific for Google Home products. # Payload specific to Google Home products.
             "attachedToGoogleStructure": True or False, # Output only. This identifies whether the subscription is attached to a Google Home structure.
+            "googleStructureId": "A String", # Optional. Structure identifier on Google side.
             "partnerStructureId": "A String", # Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.
           },
           "googleOnePayload": { # Payload specific to Google One products. # Product-specific payloads. Payload specific to Google One products.
@@ -1423,6 +1431,7 @@ 
Method Details

         "productPayload": { # Specifies product specific payload. # Optional. Product specific payload for this line item.
           "googleHomePayload": { # Payload specific for Google Home products. # Payload specific to Google Home products.
             "attachedToGoogleStructure": True or False, # Output only. This identifies whether the subscription is attached to a Google Home structure.
+            "googleStructureId": "A String", # Optional. Structure identifier on Google side.
             "partnerStructureId": "A String", # Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.
           },
           "googleOnePayload": { # Payload specific to Google One products. # Product-specific payloads. Payload specific to Google One products.
@@ -1579,6 +1588,7 @@ 
Method Details

         "productPayload": { # Specifies product specific payload. # Optional. Product specific payload for this line item.
           "googleHomePayload": { # Payload specific for Google Home products. # Payload specific to Google Home products.
             "attachedToGoogleStructure": True or False, # Output only. This identifies whether the subscription is attached to a Google Home structure.
+            "googleStructureId": "A String", # Optional. Structure identifier on Google side.
             "partnerStructureId": "A String", # Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.
           },
           "googleOnePayload": { # Payload specific to Google One products. # Product-specific payloads. Payload specific to Google One products.
diff --git a/docs/dyn/paymentsresellersubscription_v1.partners.userSessions.html b/docs/dyn/paymentsresellersubscription_v1.partners.userSessions.html
index 07c9512ea63..1d0a806d678 100644
--- a/docs/dyn/paymentsresellersubscription_v1.partners.userSessions.html
+++ b/docs/dyn/paymentsresellersubscription_v1.partners.userSessions.html
@@ -160,6 +160,7 @@ 
Method Details

             "productPayload": { # Specifies product specific payload. # Optional. Product specific payload for this line item.
               "googleHomePayload": { # Payload specific for Google Home products. # Payload specific to Google Home products.
                 "attachedToGoogleStructure": True or False, # Output only. This identifies whether the subscription is attached to a Google Home structure.
+                "googleStructureId": "A String", # Optional. Structure identifier on Google side.
                 "partnerStructureId": "A String", # Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.
               },
               "googleOnePayload": { # Payload specific to Google One products. # Product-specific payloads. Payload specific to Google One products.
diff --git a/googleapiclient/discovery_cache/documents/paymentsresellersubscription.v1.json b/googleapiclient/discovery_cache/documents/paymentsresellersubscription.v1.json
index f61114dac71..f7fcb0750c6 100644
--- a/googleapiclient/discovery_cache/documents/paymentsresellersubscription.v1.json
+++ b/googleapiclient/discovery_cache/documents/paymentsresellersubscription.v1.json
@@ -144,7 +144,7 @@
 },
 "path": "v1/{+parent}/products",
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1ListProductsResponse"
+"$ref": "ListProductsResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -173,10 +173,10 @@
 },
 "path": "v1/{+parent}/promotions:findEligible",
 "request": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1FindEligiblePromotionsRequest"
+"$ref": "FindEligiblePromotionsRequest"
 },
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1FindEligiblePromotionsResponse"
+"$ref": "FindEligiblePromotionsResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -217,7 +217,7 @@
 },
 "path": "v1/{+parent}/promotions",
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1ListPromotionsResponse"
+"$ref": "ListPromotionsResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -246,10 +246,10 @@
 },
 "path": "v1/{+name}:cancel",
 "request": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1CancelSubscriptionRequest"
+"$ref": "CancelSubscriptionRequest"
 },
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1CancelSubscriptionResponse"
+"$ref": "CancelSubscriptionResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -279,10 +279,10 @@
 },
 "path": "v1/{+parent}/subscriptions",
 "request": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Subscription"
+"$ref": "Subscription"
 },
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Subscription"
+"$ref": "Subscription"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -307,10 +307,10 @@
 },
 "path": "v1/{+name}:entitle",
 "request": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionRequest"
+"$ref": "EntitleSubscriptionRequest"
 },
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionResponse"
+"$ref": "EntitleSubscriptionResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -335,10 +335,10 @@
 },
 "path": "v1/{+name}:extend",
 "request": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1ExtendSubscriptionRequest"
+"$ref": "ExtendSubscriptionRequest"
 },
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1ExtendSubscriptionResponse"
+"$ref": "ExtendSubscriptionResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -363,7 +363,7 @@
 },
 "path": "v1/{+name}",
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Subscription"
+"$ref": "Subscription"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -393,10 +393,10 @@
 },
 "path": "v1/{+parent}/subscriptions:provision",
 "request": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Subscription"
+"$ref": "Subscription"
 },
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Subscription"
+"$ref": "Subscription"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -421,10 +421,10 @@
 },
 "path": "v1/{+name}:resume",
 "request": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1ResumeSubscriptionRequest"
+"$ref": "ResumeSubscriptionRequest"
 },
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1ResumeSubscriptionResponse"
+"$ref": "ResumeSubscriptionResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -449,10 +449,10 @@
 },
 "path": "v1/{+name}:suspend",
 "request": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1SuspendSubscriptionRequest"
+"$ref": "SuspendSubscriptionRequest"
 },
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1SuspendSubscriptionResponse"
+"$ref": "SuspendSubscriptionResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -477,10 +477,10 @@
 },
 "path": "v1/{+name}:undoCancel",
 "request": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1UndoCancelSubscriptionRequest"
+"$ref": "UndoCancelSubscriptionRequest"
 },
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1UndoCancelSubscriptionResponse"
+"$ref": "UndoCancelSubscriptionResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -509,10 +509,10 @@
 },
 "path": "v1/{+parent}/userSessions:generate",
 "request": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1GenerateUserSessionRequest"
+"$ref": "GenerateUserSessionRequest"
 },
 "response": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1GenerateUserSessionResponse"
+"$ref": "GenerateUserSessionResponse"
 },
 "scopes": [
 "https://www.googleapis.com/auth/sdm.service"
@@ -523,12 +523,12 @@
 }
 }
 },
-"revision": "20250713",
+"revision": "20250808",
 "rootUrl": "https://paymentsresellersubscription.googleapis.com/",
 "schemas": {
-"GoogleCloudPaymentsResellerSubscriptionV1Amount": {
+"Amount": {
 "description": "Describes the amount unit including the currency code.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1Amount",
+"id": "Amount",
 "properties": {
 "amountMicros": {
 "description": "Required. Amount in micros (1_000_000 micros = 1 currency unit)",
@@ -542,9 +542,9 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1CancelSubscriptionRequest": {
+"CancelSubscriptionRequest": {
 "description": "Request to cancel a subscription.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1CancelSubscriptionRequest",
+"id": "CancelSubscriptionRequest",
 "properties": {
 "cancelImmediately": {
 "description": "Optional. If true, Google will cancel the subscription immediately, and may or may not (based on the contract) issue a prorated refund for the remainder of the billing cycle. Otherwise, Google defers the cancelation at renewal_time, and will not issue a refund. - YouTube subscriptions must use this option currently. However, the user will still have access to the subscription until the end of the billing cycle.",
@@ -583,27 +583,27 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1CancelSubscriptionResponse": {
+"CancelSubscriptionResponse": {
 "description": "Response that contains the cancelled subscription resource.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1CancelSubscriptionResponse",
+"id": "CancelSubscriptionResponse",
 "properties": {
 "subscription": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Subscription",
+"$ref": "Subscription",
 "description": "The cancelled subscription resource."
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1CreateSubscriptionIntent": {
+"CreateSubscriptionIntent": {
 "description": "Intent message for creating a Subscription resource.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1CreateSubscriptionIntent",
+"id": "CreateSubscriptionIntent",
 "properties": {
 "parent": {
 "description": "Required. The parent resource name, which is the identifier of the partner.",
 "type": "string"
 },
 "subscription": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Subscription",
+"$ref": "Subscription",
 "description": "Required. The Subscription to be created."
 },
 "subscriptionId": {
@@ -613,9 +613,9 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1Duration": {
+"Duration": {
 "description": "Describes the length of a period of a time.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1Duration",
+"id": "Duration",
 "properties": {
 "count": {
 "description": "number of duration units to be included.",
@@ -641,9 +641,9 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionIntent": {
+"EntitleSubscriptionIntent": {
 "description": "Intent for entitling the previously provisioned subscription to an end user.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionIntent",
+"id": "EntitleSubscriptionIntent",
 "properties": {
 "name": {
 "description": "Required. The name of the subscription resource that is entitled to the current end user. It is in the format of \"partners/{partner_id}/subscriptions/{subscriptionId}\".",
@@ -652,23 +652,23 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionRequest": {
+"EntitleSubscriptionRequest": {
 "description": "Partner request for entitling the previously provisioned subscription to an end user. The end user identity is inferred from the request OAuth context.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionRequest",
+"id": "EntitleSubscriptionRequest",
 "properties": {
 "lineItemEntitlementDetails": {
 "description": "Optional. The line items to be entitled. If unspecified, all line items will be entitled.",
 "items": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionRequestLineItemEntitlementDetails"
+"$ref": "EntitleSubscriptionRequestLineItemEntitlementDetails"
 },
 "type": "array"
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionRequestLineItemEntitlementDetails": {
+"EntitleSubscriptionRequestLineItemEntitlementDetails": {
 "description": "The details of the line item to be entitled.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionRequestLineItemEntitlementDetails",
+"id": "EntitleSubscriptionRequestLineItemEntitlementDetails",
 "properties": {
 "lineItemIndex": {
 "description": "Required. The index of the line item to be entitled.",
@@ -685,23 +685,23 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionResponse": {
+"EntitleSubscriptionResponse": {
 "description": "Response that contains the entitled subscription resource.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionResponse",
+"id": "EntitleSubscriptionResponse",
 "properties": {
 "subscription": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Subscription",
+"$ref": "Subscription",
 "description": "The subscription that has user linked to it."
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1ExtendSubscriptionRequest": {
+"ExtendSubscriptionRequest": {
 "description": "Request message for extending a Subscription resource. A new recurrence will be made based on the subscription schedule defined by the original product.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1ExtendSubscriptionRequest",
+"id": "ExtendSubscriptionRequest",
 "properties": {
 "extension": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Extension",
+"$ref": "Extension",
 "description": "Required. Specifies details of the extension. Currently, the duration of the extension must be exactly one billing cycle of the original subscription."
 },
 "requestId": {
@@ -711,9 +711,9 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1ExtendSubscriptionResponse": {
+"ExtendSubscriptionResponse": {
 "description": "Response that contains the timestamps after the extension.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1ExtendSubscriptionResponse",
+"id": "ExtendSubscriptionResponse",
 "properties": {
 "cycleEndTime": {
 "description": "The time at which the subscription is expected to be extended, in ISO 8061 format. UTC timezone. Example, \"cycleEndTime\":\"2019-08-31T17:28:54.564Z\"",
@@ -734,12 +734,12 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1Extension": {
+"Extension": {
 "description": "Describes the details of an extension request.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1Extension",
+"id": "Extension",
 "properties": {
 "duration": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Duration",
+"$ref": "Duration",
 "description": "Required. Specifies the period of access the subscription should grant."
 },
 "partnerUserToken": {
@@ -749,9 +749,9 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1FindEligiblePromotionsRequest": {
+"FindEligiblePromotionsRequest": {
 "description": "Request to find eligible promotions for the current user.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1FindEligiblePromotionsRequest",
+"id": "FindEligiblePromotionsRequest",
 "properties": {
 "filter": {
 "description": "Optional. Specifies the filters for the promotion results. The syntax is defined in https://google.aip.dev/160 with the following caveats: 1. Only the following features are supported: - Logical operator `AND` - Comparison operator `=` (no wildcards `*`) - Traversal operator `.` - Has operator `:` (no wildcards `*`) 2. Only the following fields are supported: - `applicableProducts` - `regionCodes` - `youtubePayload.partnerEligibilityId` - `youtubePayload.postalCode` 3. Unless explicitly mentioned above, other features are not supported. Example: `applicableProducts:partners/partner1/products/product1 AND regionCodes:US AND youtubePayload.postalCode=94043 AND youtubePayload.partnerEligibilityId=eligibility-id`",
@@ -769,9 +769,9 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1FindEligiblePromotionsResponse": {
+"FindEligiblePromotionsResponse": {
 "description": "Response containing the found promotions for the current user.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1FindEligiblePromotionsResponse",
+"id": "FindEligiblePromotionsResponse",
 "properties": {
 "nextPageToken": {
 "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is empty, there are no subsequent pages.",
@@ -780,16 +780,16 @@
 "promotions": {
 "description": "The promotions for the current user.",
 "items": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Promotion"
+"$ref": "Promotion"
 },
 "type": "array"
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1FiniteBillingCycleDetails": {
+"FiniteBillingCycleDetails": {
 "description": "Details for a subscriptiin line item with finite billing cycles.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1FiniteBillingCycleDetails",
+"id": "FiniteBillingCycleDetails",
 "properties": {
 "billingCycleCountLimit": {
 "description": "Required. The number of a subscription line item billing cycles after which billing will stop automatically.",
@@ -799,37 +799,41 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1GenerateUserSessionRequest": {
+"GenerateUserSessionRequest": {
 "description": "Request to generate a user session.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1GenerateUserSessionRequest",
+"id": "GenerateUserSessionRequest",
 "properties": {
 "intentPayload": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1IntentPayload",
+"$ref": "IntentPayload",
 "description": "The user intent to generate the user session."
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1GenerateUserSessionResponse": {
+"GenerateUserSessionResponse": {
 "description": "Response that contains the details for generated user session.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1GenerateUserSessionResponse",
+"id": "GenerateUserSessionResponse",
 "properties": {
 "userSession": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1UserSession",
+"$ref": "UserSession",
 "description": "The generated user session. The token size is proportional to the size of the intent payload."
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1GoogleHomePayload": {
+"GoogleHomePayload": {
 "description": "Payload specific for Google Home products.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1GoogleHomePayload",
+"id": "GoogleHomePayload",
 "properties": {
 "attachedToGoogleStructure": {
 "description": "Output only. This identifies whether the subscription is attached to a Google Home structure.",
 "readOnly": true,
 "type": "boolean"
 },
+"googleStructureId": {
+"description": "Optional. Structure identifier on Google side.",
+"type": "string"
+},
 "partnerStructureId": {
 "description": "Optional. This identifies the structure ID on partner side that the subscription should be applied to. Only required when the partner requires structure mapping.",
 "type": "string"
@@ -837,9 +841,9 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1GoogleOnePayload": {
+"GoogleOnePayload": {
 "description": "Payload specific to Google One products.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1GoogleOnePayload",
+"id": "GoogleOnePayload",
 "properties": {
 "campaigns": {
 "description": "Campaign attributed to sales of this subscription.",
@@ -891,24 +895,39 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1IntentPayload": {
+"GoogleTypeLocalizedText": {
+"description": "Localized variant of a text in a particular language.",
+"id": "GoogleTypeLocalizedText",
+"properties": {
+"languageCode": {
+"description": "The text's BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.",
+"type": "string"
+},
+"text": {
+"description": "Localized string in the language corresponding to language_code below.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"IntentPayload": {
 "description": "The payload that describes the user intent.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1IntentPayload",
+"id": "IntentPayload",
 "properties": {
 "createIntent": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1CreateSubscriptionIntent",
+"$ref": "CreateSubscriptionIntent",
 "description": "The request to create a subscription."
 },
 "entitleIntent": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1EntitleSubscriptionIntent",
+"$ref": "EntitleSubscriptionIntent",
 "description": "The request to entitle a subscription."
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1ListProductsResponse": {
+"ListProductsResponse": {
 "description": "Response that contains the products.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1ListProductsResponse",
+"id": "ListProductsResponse",
 "properties": {
 "nextPageToken": {
 "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is empty, there are no subsequent pages.",
@@ -917,16 +936,16 @@
 "products": {
 "description": "The products for the specified partner.",
 "items": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Product"
+"$ref": "Product"
 },
 "type": "array"
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1ListPromotionsResponse": {
+"ListPromotionsResponse": {
 "description": "Response that contains the promotions.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1ListPromotionsResponse",
+"id": "ListPromotionsResponse",
 "properties": {
 "nextPageToken": {
 "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is empty, there are no subsequent pages.",
@@ -935,16 +954,16 @@
 "promotions": {
 "description": "The promotions for the specified partner.",
 "items": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Promotion"
+"$ref": "Promotion"
 },
 "type": "array"
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1Location": {
+"Location": {
 "description": "Describes a location of an end user.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1Location",
+"id": "Location",
 "properties": {
 "postalCode": {
 "description": "The postal code this location refers to. Ex. \"94043\"",
@@ -957,9 +976,9 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1Product": {
+"Product": {
 "description": "A Product resource that defines a subscription service that can be resold.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1Product",
+"id": "Product",
 "properties": {
 "bundleDetails": {
 "$ref": "ProductBundleDetails",
@@ -967,7 +986,7 @@
 "readOnly": true
 },
 "finiteBillingCycleDetails": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1FiniteBillingCycleDetails",
+"$ref": "FiniteBillingCycleDetails",
 "description": "Optional. Details for a subscription line item with finite billing cycles. If unset, the line item will be charged indefinitely."
 },
 "name": {
@@ -977,7 +996,7 @@
 "priceConfigs": {
 "description": "Output only. Price configs for the product in the available regions.",
 "items": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1ProductPriceConfig"
+"$ref": "ProductPriceConfig"
 },
 "readOnly": true,
 "type": "array"
@@ -1006,7 +1025,7 @@
 "type": "array"
 },
 "subscriptionBillingCycleDuration": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Duration",
+"$ref": "Duration",
 "description": "Output only. Specifies the length of the billing cycle of the subscription.",
 "readOnly": true
 },
@@ -1021,9 +1040,37 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1ProductBundleDetailsBundleElement": {
+"ProductBundleDetails": {
+"description": "Details for a bundle product.",
+"id": "ProductBundleDetails",
+"properties": {
+"bundleElements": {
+"description": "The individual products that are included in the bundle.",
+"items": {
+"$ref": "ProductBundleDetailsBundleElement"
+},
+"type": "array"
+},
+"entitlementMode": {
+"description": "The entitlement mode of the bundle product.",
+"enum": [
+"ENTITLEMENT_MODE_UNSPECIFIED",
+"ENTITLEMENT_MODE_FULL",
+"ENTITLEMENT_MODE_INCREMENTAL"
+],
+"enumDescriptions": [
+"Unspecified. It's reserved as an unexpected value, should not be used.",
+"All the bundle elements must be fully activated in a single request.",
+"The bundle elements could be incrementally activated."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ProductBundleDetailsBundleElement": {
 "description": "The individual product that is included in the bundle.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1ProductBundleDetailsBundleElement",
+"id": "ProductBundleDetailsBundleElement",
 "properties": {
 "product": {
 "description": "Required. Output only. Product resource name that identifies the bundle element. The format is 'partners/{partner_id}/products/{product_id}'.",
@@ -1033,31 +1080,31 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1ProductPayload": {
+"ProductPayload": {
 "description": "Specifies product specific payload.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1ProductPayload",
+"id": "ProductPayload",
 "properties": {
 "googleHomePayload": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1GoogleHomePayload",
+"$ref": "GoogleHomePayload",
 "description": "Payload specific to Google Home products."
 },
 "googleOnePayload": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1GoogleOnePayload",
+"$ref": "GoogleOnePayload",
 "description": "Product-specific payloads. Payload specific to Google One products."
 },
 "youtubePayload": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1YoutubePayload",
+"$ref": "YoutubePayload",
 "description": "Payload specific to Youtube products."
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1ProductPriceConfig": {
+"ProductPriceConfig": {
 "description": "Configs the prices in an available region.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1ProductPriceConfig",
+"id": "ProductPriceConfig",
 "properties": {
 "amount": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Amount",
+"$ref": "Amount",
 "description": "Output only. The price in the region.",
 "readOnly": true
 },
@@ -1069,9 +1116,9 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1Promotion": {
+"Promotion": {
 "description": "A Promotion resource that defines a promotion for a subscription that can be resold.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1Promotion",
+"id": "Promotion",
 "properties": {
 "applicableProducts": {
 "description": "Output only. The product ids this promotion can be applied to.",
@@ -1087,11 +1134,11 @@
 "type": "string"
 },
 "freeTrialDuration": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Duration",
+"$ref": "Duration",
 "description": "Optional. Specifies the duration of the free trial of the subscription when promotion_type is PROMOTION_TYPE_FREE_TRIAL"
 },
 "introductoryPricingDetails": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1PromotionIntroductoryPricingDetails",
+"$ref": "PromotionIntroductoryPricingDetails",
 "description": "Optional. Specifies the introductory pricing details when the promotion_type is PROMOTION_TYPE_INTRODUCTORY_PRICING."
 },
 "name": {
@@ -1137,14 +1184,14 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1PromotionIntroductoryPricingDetails": {
+"PromotionIntroductoryPricingDetails": {
 "description": "The details of a introductory pricing promotion.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1PromotionIntroductoryPricingDetails",
+"id": "PromotionIntroductoryPricingDetails",
 "properties": {
 "introductoryPricingSpecs": {
 "description": "Output only. Specifies the introductory pricing periods.",
 "items": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1PromotionIntroductoryPricingDetailsIntroductoryPricingSpec"
+"$ref": "PromotionIntroductoryPricingDetailsIntroductoryPricingSpec"
 },
 "readOnly": true,
 "type": "array"
@@ -1152,12 +1199,12 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1PromotionIntroductoryPricingDetailsIntroductoryPricingSpec": {
+"PromotionIntroductoryPricingDetailsIntroductoryPricingSpec": {
 "description": "The duration of an introductory pricing promotion.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1PromotionIntroductoryPricingDetailsIntroductoryPricingSpec",
+"id": "PromotionIntroductoryPricingDetailsIntroductoryPricingSpec",
 "properties": {
 "discountAmount": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Amount",
+"$ref": "Amount",
 "description": "Output only. The discount amount. The value is positive.",
 "readOnly": true
 },
@@ -1181,26 +1228,26 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1ResumeSubscriptionRequest": {
+"ResumeSubscriptionRequest": {
 "description": "Request to resume a suspended subscription.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1ResumeSubscriptionRequest",
+"id": "ResumeSubscriptionRequest",
 "properties": {},
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1ResumeSubscriptionResponse": {
+"ResumeSubscriptionResponse": {
 "description": "Response that contains the resumed subscription.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1ResumeSubscriptionResponse",
+"id": "ResumeSubscriptionResponse",
 "properties": {
 "subscription": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Subscription",
+"$ref": "Subscription",
 "description": "The resumed subscription resource."
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1ServicePeriod": {
+"ServicePeriod": {
 "description": "A description of what time period or moment in time the product or service is being delivered over.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1ServicePeriod",
+"id": "ServicePeriod",
 "properties": {
 "endTime": {
 "description": "Optional. The end time of the service period. Time is exclusive.",
@@ -1215,12 +1262,12 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1Subscription": {
+"Subscription": {
 "description": "A subscription serves as a central billing entity between an external partner and Google. The underlying Google services rely on the subscription state to grant or revoke the user's service entitlement. It's important to note that the subscription state may not always perfectly align with the user's service entitlement. For example, some Google services may continue providing access to the user until the current billing cycle ends, even if the subscription has been immediately canceled. However, other services may not do the same. To fully understand the specific details, please consult the relevant contract or product policy.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1Subscription",
+"id": "Subscription",
 "properties": {
 "cancellationDetails": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionCancellationDetails",
+"$ref": "SubscriptionCancellationDetails",
 "description": "Output only. Describes the details of a cancelled subscription. Only applicable to subscription of state `STATE_CANCELLED`.",
 "readOnly": true
 },
@@ -1250,12 +1297,12 @@
 "lineItems": {
 "description": "Required. The line items of the subscription.",
 "items": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItem"
+"$ref": "SubscriptionLineItem"
 },
 "type": "array"
 },
 "migrationDetails": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionMigrationDetails",
+"$ref": "SubscriptionMigrationDetails",
 "description": "Output only. Describes the details of the migrated subscription. Only populated if this subscription is migrated from another system.",
 "readOnly": true
 },
@@ -1292,7 +1339,7 @@
 "promotionSpecs": {
 "description": "Optional. Subscription-level promotions. Only free trial is supported on this level. It determines the first renewal time of the subscription to be the end of the free trial period. Specify the promotion resource name only when used as input.",
 "items": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionPromotionSpec"
+"$ref": "SubscriptionPromotionSpec"
 },
 "type": "array"
 },
@@ -1320,7 +1367,7 @@
 "type": "string"
 },
 "serviceLocation": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Location",
+"$ref": "Location",
 "description": "Required. The location that the service is provided as indicated by the partner."
 },
 "state": {
@@ -1353,15 +1400,15 @@
 "type": "string"
 },
 "upgradeDowngradeDetails": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionUpgradeDowngradeDetails",
+"$ref": "SubscriptionUpgradeDowngradeDetails",
 "description": "Optional. Details about the previous subscription that this new subscription upgrades/downgrades from. Only populated if this subscription is an upgrade/downgrade from another subscription."
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1SubscriptionCancellationDetails": {
+"SubscriptionCancellationDetails": {
 "description": "Describes the details of a cancelled or cancelling subscription.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionCancellationDetails",
+"id": "SubscriptionCancellationDetails",
 "properties": {
 "reason": {
 "description": "Output only. The reason of the cancellation.",
@@ -1397,12 +1444,12 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItem": {
+"SubscriptionLineItem": {
 "description": "Individual line item definition of a subscription.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItem",
+"id": "SubscriptionLineItem",
 "properties": {
 "amount": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Amount",
+"$ref": "Amount",
 "description": "Output only. The price of the product/service in this line item. The amount could be the wholesale price, or it can include a cost of sale based on the contract.",
 "readOnly": true
 },
@@ -1417,7 +1464,7 @@
 "type": "string"
 },
 "finiteBillingCycleDetails": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1FiniteBillingCycleDetails",
+"$ref": "FiniteBillingCycleDetails",
 "description": "Optional. Details for a subscription line item with finite billing cycles. If unset, the line item will be charged indefinitely. Used only with LINE_ITEM_RECURRENCE_TYPE_PERIODIC."
 },
 "lineItemFreeTrialEndTime": {
@@ -1435,12 +1482,12 @@
 "lineItemPromotionSpecs": {
 "description": "Optional. The promotions applied on the line item. It can be: - an introductory pricing promotion. - a free trial promotion. This feature is not enabled. If used, the request will be rejected. When used as input in Create or Provision API, specify its resource name only.",
 "items": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionPromotionSpec"
+"$ref": "SubscriptionPromotionSpec"
 },
 "type": "array"
 },
 "oneTimeRecurrenceDetails": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItemOneTimeRecurrenceDetails",
+"$ref": "SubscriptionLineItemOneTimeRecurrenceDetails",
 "description": "Output only. Details only set for a ONE_TIME recurrence line item.",
 "readOnly": true
 },
@@ -1449,7 +1496,7 @@
 "type": "string"
 },
 "productPayload": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1ProductPayload",
+"$ref": "ProductPayload",
 "description": "Optional. Product specific payload for this line item."
 },
 "recurrenceType": {
@@ -1495,9 +1542,24 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItemBundleDetailsBundleElementDetails": {
+"SubscriptionLineItemBundleDetails": {
+"description": "The bundle details for a line item corresponding to a hard bundle.",
+"id": "SubscriptionLineItemBundleDetails",
+"properties": {
+"bundleElementDetails": {
+"description": "Output only. The details for each element in the hard bundle.",
+"items": {
+"$ref": "SubscriptionLineItemBundleDetailsBundleElementDetails"
+},
+"readOnly": true,
+"type": "array"
+}
+},
+"type": "object"
+},
+"SubscriptionLineItemBundleDetailsBundleElementDetails": {
 "description": "The details for an element in the hard bundle.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItemBundleDetailsBundleElementDetails",
+"id": "SubscriptionLineItemBundleDetailsBundleElementDetails",
 "properties": {
 "product": {
 "description": "Output only. Product resource name that identifies the bundle element. The format is 'partners/{partner_id}/products/{product_id}'.",
@@ -1513,21 +1575,21 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItemOneTimeRecurrenceDetails": {
+"SubscriptionLineItemOneTimeRecurrenceDetails": {
 "description": "Details for a ONE_TIME recurrence line item.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItemOneTimeRecurrenceDetails",
+"id": "SubscriptionLineItemOneTimeRecurrenceDetails",
 "properties": {
 "servicePeriod": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1ServicePeriod",
+"$ref": "ServicePeriod",
 "description": "Output only. The service period of the ONE_TIME line item.",
 "readOnly": true
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1SubscriptionMigrationDetails": {
+"SubscriptionMigrationDetails": {
 "description": "Describes the details of the migrated subscription.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionMigrationDetails",
+"id": "SubscriptionMigrationDetails",
 "properties": {
 "migratedSubscriptionId": {
 "description": "Output only. The migrated subscription id in the legacy system.",
@@ -1537,17 +1599,17 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1SubscriptionPromotionSpec": {
+"SubscriptionPromotionSpec": {
 "description": "Describes the spec for one promotion.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionPromotionSpec",
+"id": "SubscriptionPromotionSpec",
 "properties": {
 "freeTrialDuration": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Duration",
+"$ref": "Duration",
 "description": "Output only. The duration of the free trial if the promotion is of type FREE_TRIAL.",
 "readOnly": true
 },
 "introductoryPricingDetails": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1PromotionIntroductoryPricingDetails",
+"$ref": "PromotionIntroductoryPricingDetails",
 "description": "Output only. The details of the introductory pricing spec if the promotion is of type INTRODUCTORY_PRICING.",
 "readOnly": true
 },
@@ -1573,9 +1635,9 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1SubscriptionUpgradeDowngradeDetails": {
+"SubscriptionUpgradeDowngradeDetails": {
 "description": "Details about the previous subscription that this new subscription upgrades/downgrades from.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionUpgradeDowngradeDetails",
+"id": "SubscriptionUpgradeDowngradeDetails",
 "properties": {
 "billingCycleSpec": {
 "description": "Required. Specifies the billing cycle spec for the new upgraded/downgraded subscription.",
@@ -1600,43 +1662,43 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1SuspendSubscriptionRequest": {
+"SuspendSubscriptionRequest": {
 "description": "Request to suspend a subscription.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1SuspendSubscriptionRequest",
+"id": "SuspendSubscriptionRequest",
 "properties": {},
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1SuspendSubscriptionResponse": {
+"SuspendSubscriptionResponse": {
 "description": "Response that contains the suspended subscription.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1SuspendSubscriptionResponse",
+"id": "SuspendSubscriptionResponse",
 "properties": {
 "subscription": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Subscription",
+"$ref": "Subscription",
 "description": "The suspended subscription resource."
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1UndoCancelSubscriptionRequest": {
+"UndoCancelSubscriptionRequest": {
 "description": "Request to revoke a cancellation request.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1UndoCancelSubscriptionRequest",
+"id": "UndoCancelSubscriptionRequest",
 "properties": {},
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1UndoCancelSubscriptionResponse": {
+"UndoCancelSubscriptionResponse": {
 "description": "Response that contains the updated subscription resource.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1UndoCancelSubscriptionResponse",
+"id": "UndoCancelSubscriptionResponse",
 "properties": {
 "subscription": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1Subscription",
+"$ref": "Subscription",
 "description": "The updated subscription resource."
 }
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1UserSession": {
+"UserSession": {
 "description": "A user session contains a short-lived token that includes information required to interact with Google Payments Reseller Platform using the following web endpoints. - A user session token should be generated dynamically for an authenticated user. You should refrain from sharing a token directly with a user in an unauthenticated context, such as SMS, or email. - You can re-generate new session tokens repeatedly for same `generate` request if necessary, regardless of the previous tokens being expired or not. You don't need to worry about multiple sessions resulting in duplicate fulfillments as guaranteed by the same subscription id. Please refer to the [Google Managed Signup](/payments/reseller/subscription/reference/index/User.Signup.Integration/Google.Managed.Signup) documentation for additional integration details.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1UserSession",
+"id": "UserSession",
 "properties": {
 "expireTime": {
 "description": "Output only. The time at which the user session expires.",
@@ -1652,9 +1714,9 @@
 },
 "type": "object"
 },
-"GoogleCloudPaymentsResellerSubscriptionV1YoutubePayload": {
+"YoutubePayload": {
 "description": "Payload specific to Youtube products.",
-"id": "GoogleCloudPaymentsResellerSubscriptionV1YoutubePayload",
+"id": "YoutubePayload",
 "properties": {
 "accessEndTime": {
 "description": "Output only. The access expiration time for this line item.",
@@ -1687,64 +1749,6 @@
 }
 },
 "type": "object"
-},
-"GoogleTypeLocalizedText": {
-"description": "Localized variant of a text in a particular language.",
-"id": "GoogleTypeLocalizedText",
-"properties": {
-"languageCode": {
-"description": "The text's BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.",
-"type": "string"
-},
-"text": {
-"description": "Localized string in the language corresponding to language_code below.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"ProductBundleDetails": {
-"description": "Details for a bundle product.",
-"id": "ProductBundleDetails",
-"properties": {
-"bundleElements": {
-"description": "The individual products that are included in the bundle.",
-"items": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1ProductBundleDetailsBundleElement"
-},
-"type": "array"
-},
-"entitlementMode": {
-"description": "The entitlement mode of the bundle product.",
-"enum": [
-"ENTITLEMENT_MODE_UNSPECIFIED",
-"ENTITLEMENT_MODE_FULL",
-"ENTITLEMENT_MODE_INCREMENTAL"
-],
-"enumDescriptions": [
-"Unspecified. It's reserved as an unexpected value, should not be used.",
-"All the bundle elements must be fully activated in a single request.",
-"The bundle elements could be incrementally activated."
-],
-"type": "string"
-}
-},
-"type": "object"
-},
-"SubscriptionLineItemBundleDetails": {
-"description": "The bundle details for a line item corresponding to a hard bundle.",
-"id": "SubscriptionLineItemBundleDetails",
-"properties": {
-"bundleElementDetails": {
-"description": "Output only. The details for each element in the hard bundle.",
-"items": {
-"$ref": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItemBundleDetailsBundleElementDetails"
-},
-"readOnly": true,
-"type": "array"
-}
-},
-"type": "object"
 }
 },
 "servicePath": "",

From b66abd75313a7e6076d41b7bb133330f9919f720 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:00 +0000
Subject: [PATCH 28/32] feat(redis): update the api

#### redis:v1

The following keys were added:
- schemas.DatabaseResourceFeed.properties.skipIngestion.type (Total Keys: 1)
---
 .../discovery_cache/documents/redis.v1.json   | 22 ++++++++++++++-----
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/googleapiclient/discovery_cache/documents/redis.v1.json b/googleapiclient/discovery_cache/documents/redis.v1.json
index 2f8483f68f2..c46763e6a4c 100644
--- a/googleapiclient/discovery_cache/documents/redis.v1.json
+++ b/googleapiclient/discovery_cache/documents/redis.v1.json
@@ -1073,7 +1073,7 @@
 }
 }
 },
-"revision": "20250729",
+"revision": "20250807",
 "rootUrl": "https://redis.googleapis.com/",
 "schemas": {
 "AOFConfig": {
@@ -1993,7 +1993,7 @@
 "type": "object"
 },
 "DatabaseResourceFeed": {
-"description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 10",
+"description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 11",
 "id": "DatabaseResourceFeed",
 "properties": {
 "backupdrMetadata": {
@@ -2047,6 +2047,10 @@
 },
 "resourceMetadata": {
 "$ref": "DatabaseResourceMetadata"
+},
+"skipIngestion": {
+"description": "Optional. If true, the feed won't be ingested by DB Center. This indicates that the feed is intentionally skipped. For example, BackupDR feeds are only needed for resources integrated with DB Center (e.g., CloudSQL, AlloyDB). Feeds for non-integrated resources (e.g., Compute Engine, Persistent Disk) can be skipped.",
+"type": "boolean"
 }
 },
 "type": "object"
@@ -2266,7 +2270,8 @@
 "SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED",
 "SIGNAL_TYPE_MANY_IDLE_CONNECTIONS",
 "SIGNAL_TYPE_REPLICATION_LAG",
-"SIGNAL_TYPE_OUTDATED_VERSION"
+"SIGNAL_TYPE_OUTDATED_VERSION",
+"SIGNAL_TYPE_OUTDATED_CLIENT"
 ],
 "enumDeprecated": [
 false,
@@ -2369,6 +2374,7 @@ false,
 false,
 false,
 false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -2472,7 +2478,8 @@ false
 "Schema not optimized.",
 "High number of idle connections.",
 "Replication delay.",
-"Outdated version."
+"Outdated version.",
+"Outdated client."
 ],
 "type": "string"
 },
@@ -2899,7 +2906,8 @@ false
 "SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED",
 "SIGNAL_TYPE_MANY_IDLE_CONNECTIONS",
 "SIGNAL_TYPE_REPLICATION_LAG",
-"SIGNAL_TYPE_OUTDATED_VERSION"
+"SIGNAL_TYPE_OUTDATED_VERSION",
+"SIGNAL_TYPE_OUTDATED_CLIENT"
 ],
 "enumDeprecated": [
 false,
@@ -3002,6 +3010,7 @@ false,
 false,
 false,
 false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -3105,7 +3114,8 @@ false
 "Schema not optimized.",
 "High number of idle connections.",
 "Replication delay.",
-"Outdated version."
+"Outdated version.",
+"Outdated client."
 ],
 "type": "string"
 }

From 2c2848b42fb992047308ee8ee0f35b65edf633b3 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:00 +0000
Subject: [PATCH 29/32] feat(run): update the api

#### run:v2

The following keys were added:
- schemas.GoogleCloudRunV2SubmitBuildRequest.properties.machineType.type (Total Keys: 1)
---
 docs/dyn/run_v1.namespaces.workerpools.html   | 60 +++++++++----------
 .../dyn/run_v2.projects.locations.builds.html |  1 +
 ...run_v2.projects.locations.workerPools.html | 24 ++++----
 .../discovery_cache/documents/run.v1.json     |  8 +--
 .../discovery_cache/documents/run.v2.json     | 12 ++--
 5 files changed, 55 insertions(+), 50 deletions(-)

diff --git a/docs/dyn/run_v1.namespaces.workerpools.html b/docs/dyn/run_v1.namespaces.workerpools.html
index f39e73b1f29..dd608f70944 100644
--- a/docs/dyn/run_v1.namespaces.workerpools.html
+++ b/docs/dyn/run_v1.namespaces.workerpools.html
@@ -145,8 +145,8 @@ 
Method Details

   "spec": { # WorkerPoolSpec holds the desired state of the WorkerPool's template and instance splits. # Holds the desired state of the WorkerPool (from the client).
     "instanceSplits": [ # Specifies how to distribute instances over a collection of Revisions.
       { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-        "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+        "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
         "revisionName": "A String", # Revision to which to assign this portion of instances.
       },
     ],
@@ -437,10 +437,10 @@ 
Method Details

         "type": "A String", # type is used to communicate the status of the reconciliation process. Types common to all resources include: * "Ready" or "Completed": True when the Resource is ready.
       },
     ],
-    "instanceSplits": [ # Holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+    "instanceSplits": [ # Holds the configured workload distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
       { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-        "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+        "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
         "revisionName": "A String", # Revision to which to assign this portion of instances.
       },
     ],
@@ -497,8 +497,8 @@ 
Method Details

   "spec": { # WorkerPoolSpec holds the desired state of the WorkerPool's template and instance splits. # Holds the desired state of the WorkerPool (from the client).
     "instanceSplits": [ # Specifies how to distribute instances over a collection of Revisions.
       { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-        "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+        "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
         "revisionName": "A String", # Revision to which to assign this portion of instances.
       },
     ],
@@ -789,10 +789,10 @@ 
Method Details

         "type": "A String", # type is used to communicate the status of the reconciliation process. Types common to all resources include: * "Ready" or "Completed": True when the Resource is ready.
       },
     ],
-    "instanceSplits": [ # Holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+    "instanceSplits": [ # Holds the configured workload distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
       { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-        "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+        "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
         "revisionName": "A String", # Revision to which to assign this portion of instances.
       },
     ],
@@ -897,8 +897,8 @@ 
Method Details

   "spec": { # WorkerPoolSpec holds the desired state of the WorkerPool's template and instance splits. # Holds the desired state of the WorkerPool (from the client).
     "instanceSplits": [ # Specifies how to distribute instances over a collection of Revisions.
       { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-        "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+        "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
         "revisionName": "A String", # Revision to which to assign this portion of instances.
       },
     ],
@@ -1189,10 +1189,10 @@ 
Method Details

         "type": "A String", # type is used to communicate the status of the reconciliation process. Types common to all resources include: * "Ready" or "Completed": True when the Resource is ready.
       },
     ],
-    "instanceSplits": [ # Holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+    "instanceSplits": [ # Holds the configured workload distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
       { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-        "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+        "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
         "revisionName": "A String", # Revision to which to assign this portion of instances.
       },
     ],
@@ -1261,8 +1261,8 @@ 
Method Details

       "spec": { # WorkerPoolSpec holds the desired state of the WorkerPool's template and instance splits. # Holds the desired state of the WorkerPool (from the client).
         "instanceSplits": [ # Specifies how to distribute instances over a collection of Revisions.
           { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-            "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-            "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+            "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+            "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
             "revisionName": "A String", # Revision to which to assign this portion of instances.
           },
         ],
@@ -1553,10 +1553,10 @@ 
Method Details

             "type": "A String", # type is used to communicate the status of the reconciliation process. Types common to all resources include: * "Ready" or "Completed": True when the Resource is ready.
           },
         ],
-        "instanceSplits": [ # Holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+        "instanceSplits": [ # Holds the configured workload distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
           { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-            "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-            "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+            "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+            "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
             "revisionName": "A String", # Revision to which to assign this portion of instances.
           },
         ],
@@ -1625,8 +1625,8 @@ 
Method Details

   "spec": { # WorkerPoolSpec holds the desired state of the WorkerPool's template and instance splits. # Holds the desired state of the WorkerPool (from the client).
     "instanceSplits": [ # Specifies how to distribute instances over a collection of Revisions.
       { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-        "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+        "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
         "revisionName": "A String", # Revision to which to assign this portion of instances.
       },
     ],
@@ -1917,10 +1917,10 @@ 
Method Details

         "type": "A String", # type is used to communicate the status of the reconciliation process. Types common to all resources include: * "Ready" or "Completed": True when the Resource is ready.
       },
     ],
-    "instanceSplits": [ # Holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+    "instanceSplits": [ # Holds the configured workload distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
       { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-        "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+        "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
         "revisionName": "A String", # Revision to which to assign this portion of instances.
       },
     ],
@@ -1977,8 +1977,8 @@ 
Method Details

   "spec": { # WorkerPoolSpec holds the desired state of the WorkerPool's template and instance splits. # Holds the desired state of the WorkerPool (from the client).
     "instanceSplits": [ # Specifies how to distribute instances over a collection of Revisions.
       { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-        "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+        "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
         "revisionName": "A String", # Revision to which to assign this portion of instances.
       },
     ],
@@ -2269,10 +2269,10 @@ 
Method Details

         "type": "A String", # type is used to communicate the status of the reconciliation process. Types common to all resources include: * "Ready" or "Completed": True when the Resource is ready.
       },
     ],
-    "instanceSplits": [ # Holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
+    "instanceSplits": [ # Holds the configured workload distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
       { # Holds a single instance split entry for the Worker. Allocations can be done to a specific Revision name, or pointing to the latest Ready Revision.
-        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the traffic target. When it changes, traffic will automatically migrate from the prior "latest ready" revision to the new one.
-        "percent": 42, # Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
+        "latestRevision": True or False, # Uses the "status.latestReadyRevisionName" to determine the instance split target. When it changes, workloads will automatically migrate from the prior "latest ready" revision to the new one.
+        "percent": 42, # Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.
         "revisionName": "A String", # Revision to which to assign this portion of instances.
       },
     ],
diff --git a/docs/dyn/run_v2.projects.locations.builds.html b/docs/dyn/run_v2.projects.locations.builds.html
index cac3dbbfe53..e73cef9ec98 100644
--- a/docs/dyn/run_v2.projects.locations.builds.html
+++ b/docs/dyn/run_v2.projects.locations.builds.html
@@ -110,6 +110,7 @@ 
Method Details

   "dockerBuild": { # Build the source using Docker. This means the source has a Dockerfile. # Build the source using Docker. This means the source has a Dockerfile.
   },
   "imageUri": "A String", # Required. Artifact Registry URI to store the built image.
+  "machineType": "A String", # Optional. The machine type from default pool to use for the build. If left blank, cloudbuild will use a sensible default. Currently only E2_HIGHCPU_8 is supported. If worker_pool is set, this field will be ignored.
   "serviceAccount": "A String", # Optional. The service account to use for the build. If not set, the default Cloud Build service account for the project will be used.
   "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # Required. Source for the build.
     "bucket": "A String", # Required. Google Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
diff --git a/docs/dyn/run_v2.projects.locations.workerPools.html b/docs/dyn/run_v2.projects.locations.workerPools.html
index fcece7bd414..afca7c507b0 100644
--- a/docs/dyn/run_v2.projects.locations.workerPools.html
+++ b/docs/dyn/run_v2.projects.locations.workerPools.html
@@ -176,11 +176,11 @@ 
Method Details

   },
   "lastModifier": "A String", # Output only. Email address of the last authenticated modifier.
   "latestCreatedRevision": "A String", # Output only. Name of the last created revision. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
-  "latestReadyRevision": "A String", # Output only. Name of the latest revision that is serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
+  "latestReadyRevision": "A String", # Output only. Name of the latest revision that is serving workloads. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
   "launchStage": "A String", # Optional. The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA on output.
   "name": "A String", # The fully qualified name of this WorkerPool. In CreateWorkerPoolRequest, this field is ignored, and instead composed from CreateWorkerPoolRequest.parent and CreateWorkerPoolRequest.worker_id. Format: `projects/{project}/locations/{location}/workerPools/{worker_id}`
-  "observedGeneration": "A String", # Output only. The generation of this WorkerPool currently serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. 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`.
-  "reconciling": True or False, # Output only. Returns true if the WorkerPool is currently being acted upon by the system to bring it into the desired state. When a new WorkerPool is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the WorkerPool to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `traffic_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the WorkerPool, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `traffic` and `traffic_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `traffic_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created WorkerPools. Additional information on the failure can be found in `terminal_condition` and `conditions`.
+  "observedGeneration": "A String", # Output only. The generation of this WorkerPool currently serving workloads. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. 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`.
+  "reconciling": True or False, # Output only. Returns true if the WorkerPool is currently being acted upon by the system to bring it into the desired state. When a new WorkerPool is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the WorkerPool to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `instance_split_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the WorkerPool, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `instance_splits` and `instance_split_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `instance_split_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created WorkerPools. Additional information on the failure can be found in `terminal_condition` and `conditions`.
   "satisfiesPzs": True or False, # Output only. Reserved for future use.
   "scaling": { # Worker pool scaling settings. # Optional. Specifies worker-pool-level scaling settings
     "manualInstanceCount": 42, # Optional. The total number of instances in manual scaling mode.
@@ -501,11 +501,11 @@ 
Method Details

   },
   "lastModifier": "A String", # Output only. Email address of the last authenticated modifier.
   "latestCreatedRevision": "A String", # Output only. Name of the last created revision. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
-  "latestReadyRevision": "A String", # Output only. Name of the latest revision that is serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
+  "latestReadyRevision": "A String", # Output only. Name of the latest revision that is serving workloads. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
   "launchStage": "A String", # Optional. The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA on output.
   "name": "A String", # The fully qualified name of this WorkerPool. In CreateWorkerPoolRequest, this field is ignored, and instead composed from CreateWorkerPoolRequest.parent and CreateWorkerPoolRequest.worker_id. Format: `projects/{project}/locations/{location}/workerPools/{worker_id}`
-  "observedGeneration": "A String", # Output only. The generation of this WorkerPool currently serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. 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`.
-  "reconciling": True or False, # Output only. Returns true if the WorkerPool is currently being acted upon by the system to bring it into the desired state. When a new WorkerPool is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the WorkerPool to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `traffic_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the WorkerPool, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `traffic` and `traffic_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `traffic_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created WorkerPools. Additional information on the failure can be found in `terminal_condition` and `conditions`.
+  "observedGeneration": "A String", # Output only. The generation of this WorkerPool currently serving workloads. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. 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`.
+  "reconciling": True or False, # Output only. Returns true if the WorkerPool is currently being acted upon by the system to bring it into the desired state. When a new WorkerPool is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the WorkerPool to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `instance_split_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the WorkerPool, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `instance_splits` and `instance_split_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `instance_split_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created WorkerPools. Additional information on the failure can be found in `terminal_condition` and `conditions`.
   "satisfiesPzs": True or False, # Output only. Reserved for future use.
   "scaling": { # Worker pool scaling settings. # Optional. Specifies worker-pool-level scaling settings
     "manualInstanceCount": 42, # Optional. The total number of instances in manual scaling mode.
@@ -813,11 +813,11 @@ 
Method Details

       },
       "lastModifier": "A String", # Output only. Email address of the last authenticated modifier.
       "latestCreatedRevision": "A String", # Output only. Name of the last created revision. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
-      "latestReadyRevision": "A String", # Output only. Name of the latest revision that is serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
+      "latestReadyRevision": "A String", # Output only. Name of the latest revision that is serving workloads. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
       "launchStage": "A String", # Optional. The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA on output.
       "name": "A String", # The fully qualified name of this WorkerPool. In CreateWorkerPoolRequest, this field is ignored, and instead composed from CreateWorkerPoolRequest.parent and CreateWorkerPoolRequest.worker_id. Format: `projects/{project}/locations/{location}/workerPools/{worker_id}`
-      "observedGeneration": "A String", # Output only. The generation of this WorkerPool currently serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. 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`.
-      "reconciling": True or False, # Output only. Returns true if the WorkerPool is currently being acted upon by the system to bring it into the desired state. When a new WorkerPool is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the WorkerPool to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `traffic_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the WorkerPool, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `traffic` and `traffic_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `traffic_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created WorkerPools. Additional information on the failure can be found in `terminal_condition` and `conditions`.
+      "observedGeneration": "A String", # Output only. The generation of this WorkerPool currently serving workloads. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. 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`.
+      "reconciling": True or False, # Output only. Returns true if the WorkerPool is currently being acted upon by the system to bring it into the desired state. When a new WorkerPool is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the WorkerPool to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `instance_split_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the WorkerPool, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `instance_splits` and `instance_split_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `instance_split_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created WorkerPools. Additional information on the failure can be found in `terminal_condition` and `conditions`.
       "satisfiesPzs": True or False, # Output only. Reserved for future use.
       "scaling": { # Worker pool scaling settings. # Optional. Specifies worker-pool-level scaling settings
         "manualInstanceCount": 42, # Optional. The total number of instances in manual scaling mode.
@@ -1082,11 +1082,11 @@ 
Method Details

   },
   "lastModifier": "A String", # Output only. Email address of the last authenticated modifier.
   "latestCreatedRevision": "A String", # Output only. Name of the last created revision. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
-  "latestReadyRevision": "A String", # Output only. Name of the latest revision that is serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
+  "latestReadyRevision": "A String", # Output only. Name of the latest revision that is serving workloads. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
   "launchStage": "A String", # Optional. The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA on output.
   "name": "A String", # The fully qualified name of this WorkerPool. In CreateWorkerPoolRequest, this field is ignored, and instead composed from CreateWorkerPoolRequest.parent and CreateWorkerPoolRequest.worker_id. Format: `projects/{project}/locations/{location}/workerPools/{worker_id}`
-  "observedGeneration": "A String", # Output only. The generation of this WorkerPool currently serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. 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`.
-  "reconciling": True or False, # Output only. Returns true if the WorkerPool is currently being acted upon by the system to bring it into the desired state. When a new WorkerPool is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the WorkerPool to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `traffic_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the WorkerPool, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `traffic` and `traffic_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `traffic_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created WorkerPools. Additional information on the failure can be found in `terminal_condition` and `conditions`.
+  "observedGeneration": "A String", # Output only. The generation of this WorkerPool currently serving workloads. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. 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`.
+  "reconciling": True or False, # Output only. Returns true if the WorkerPool is currently being acted upon by the system to bring it into the desired state. When a new WorkerPool is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the WorkerPool to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `instance_split_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the WorkerPool, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `instance_splits` and `instance_split_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `instance_split_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created WorkerPools. Additional information on the failure can be found in `terminal_condition` and `conditions`.
   "satisfiesPzs": True or False, # Output only. Reserved for future use.
   "scaling": { # Worker pool scaling settings. # Optional. Specifies worker-pool-level scaling settings
     "manualInstanceCount": 42, # Optional. The total number of instances in manual scaling mode.
diff --git a/googleapiclient/discovery_cache/documents/run.v1.json b/googleapiclient/discovery_cache/documents/run.v1.json
index 2abe6f77013..6cc1caaa6a6 100644
--- a/googleapiclient/discovery_cache/documents/run.v1.json
+++ b/googleapiclient/discovery_cache/documents/run.v1.json
@@ -2887,7 +2887,7 @@
 }
 }
 },
-"revision": "20250704",
+"revision": "20250801",
 "rootUrl": "https://run.googleapis.com/",
 "schemas": {
 "Addressable": {
@@ -5317,11 +5317,11 @@ false
 "id": "InstanceSplit",
 "properties": {
 "latestRevision": {
-"description": "Uses the \"status.latestReadyRevisionName\" to determine the traffic target. When it changes, traffic will automatically migrate from the prior \"latest ready\" revision to the new one.",
+"description": "Uses the \"status.latestReadyRevisionName\" to determine the instance split target. When it changes, workloads will automatically migrate from the prior \"latest ready\" revision to the new one.",
 "type": "boolean"
 },
 "percent": {
-"description": "Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.",
+"description": "Optional. Specifies percent of the instance split to this Revision. This defaults to zero if unspecified.",
 "format": "int32",
 "type": "integer"
 },
@@ -6942,7 +6942,7 @@ false
 "type": "array"
 },
 "instanceSplits": {
-"description": "Holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.",
+"description": "Holds the configured workload distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.",
 "items": {
 "$ref": "InstanceSplit"
 },
diff --git a/googleapiclient/discovery_cache/documents/run.v2.json b/googleapiclient/discovery_cache/documents/run.v2.json
index fec383d6097..78fd96d8b4e 100644
--- a/googleapiclient/discovery_cache/documents/run.v2.json
+++ b/googleapiclient/discovery_cache/documents/run.v2.json
@@ -1922,7 +1922,7 @@
 }
 }
 },
-"revision": "20250718",
+"revision": "20250801",
 "rootUrl": "https://run.googleapis.com/",
 "schemas": {
 "GoogleCloudRunV2BinaryAuthorization": {
@@ -4097,6 +4097,10 @@
 "description": "Required. Artifact Registry URI to store the built image.",
 "type": "string"
 },
+"machineType": {
+"description": "Optional. The machine type from default pool to use for the build. If left blank, cloudbuild will use a sensible default. Currently only E2_HIGHCPU_8 is supported. If worker_pool is set, this field will be ignored.",
+"type": "string"
+},
 "serviceAccount": {
 "description": "Optional. The service account to use for the build. If not set, the default Cloud Build service account for the project will be used.",
 "type": "string"
@@ -4721,7 +4725,7 @@
 "type": "string"
 },
 "latestReadyRevision": {
-"description": "Output only. Name of the latest revision that is serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.",
+"description": "Output only. Name of the latest revision that is serving workloads. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.",
 "readOnly": true,
 "type": "string"
 },
@@ -4754,13 +4758,13 @@
 "type": "string"
 },
 "observedGeneration": {
-"description": "Output only. The generation of this WorkerPool currently serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. 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`.",
+"description": "Output only. The generation of this WorkerPool currently serving workloads. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. 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`.",
 "format": "int64",
 "readOnly": true,
 "type": "string"
 },
 "reconciling": {
-"description": "Output only. Returns true if the WorkerPool is currently being acted upon by the system to bring it into the desired state. When a new WorkerPool is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the WorkerPool to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `traffic_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the WorkerPool, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `traffic` and `traffic_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `traffic_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created WorkerPools. Additional information on the failure can be found in `terminal_condition` and `conditions`.",
+"description": "Output only. Returns true if the WorkerPool is currently being acted upon by the system to bring it into the desired state. When a new WorkerPool is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the WorkerPool to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `instance_split_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the WorkerPool, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `instance_splits` and `instance_split_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `instance_split_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created WorkerPools. Additional information on the failure can be found in `terminal_condition` and `conditions`.",
 "readOnly": true,
 "type": "boolean"
 },

From 2eb8b9996fe840123072a9aa6b1dd07bac63da40 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:01 +0000
Subject: [PATCH 30/32] feat(texttospeech): update the api

#### texttospeech:v1

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

#### texttospeech:v1beta1

The following keys were added:
- schemas.VoiceSelectionParams.properties.modelName.type (Total Keys: 1)
---
 docs/dyn/texttospeech_v1.projects.locations.html            | 1 +
 docs/dyn/texttospeech_v1.text.html                          | 1 +
 docs/dyn/texttospeech_v1beta1.projects.locations.html       | 1 +
 docs/dyn/texttospeech_v1beta1.text.html                     | 1 +
 .../discovery_cache/documents/texttospeech.v1.json          | 6 +++++-
 .../discovery_cache/documents/texttospeech.v1beta1.json     | 6 +++++-
 6 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/docs/dyn/texttospeech_v1.projects.locations.html b/docs/dyn/texttospeech_v1.projects.locations.html
index fca3cb7316d..0610ef62f03 100644
--- a/docs/dyn/texttospeech_v1.projects.locations.html
+++ b/docs/dyn/texttospeech_v1.projects.locations.html
@@ -140,6 +140,7 @@ 
Method Details

       "reportedUsage": "A String", # Optional. Deprecated. The usage of the synthesized audio to be reported.
     },
     "languageCode": "A String", # Required. The language (and potentially also the region) of the voice expressed as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. "en-US". This should not include a script tag (e.g. use "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred from the input provided in the SynthesisInput. The TTS service will use this parameter to help choose an appropriate voice. Note that the TTS service may choose a voice with a slightly different language code than the one selected; it may substitute a different region (e.g. using en-US rather than en-CA if there isn't a Canadian voice available), or even a different language, e.g. using "nb" (Norwegian Bokmal) instead of "no" (Norwegian)".
+    "modelName": "A String", # Optional. The name of the model. If set, the service will choose the model matching the specified configuration.
     "name": "A String", # The name of the voice. If both the name and the gender are not set, the service will choose a voice based on the other parameters such as language_code.
     "ssmlGender": "A String", # The preferred gender of the voice. If not set, the service will choose a voice based on the other parameters such as language_code and name. Note that this is only a preference, not requirement; if a voice of the appropriate gender is not available, the synthesizer should substitute a voice with a different gender rather than failing the request.
     "voiceClone": { # The configuration of Voice Clone feature. # Optional. The configuration for a voice clone. If [VoiceCloneParams.voice_clone_key] is set, the service chooses the voice clone matching the specified configuration.
diff --git a/docs/dyn/texttospeech_v1.text.html b/docs/dyn/texttospeech_v1.text.html
index b04b1529f46..f8aaf846040 100644
--- a/docs/dyn/texttospeech_v1.text.html
+++ b/docs/dyn/texttospeech_v1.text.html
@@ -136,6 +136,7 @@ 
Method Details

       "reportedUsage": "A String", # Optional. Deprecated. The usage of the synthesized audio to be reported.
     },
     "languageCode": "A String", # Required. The language (and potentially also the region) of the voice expressed as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. "en-US". This should not include a script tag (e.g. use "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred from the input provided in the SynthesisInput. The TTS service will use this parameter to help choose an appropriate voice. Note that the TTS service may choose a voice with a slightly different language code than the one selected; it may substitute a different region (e.g. using en-US rather than en-CA if there isn't a Canadian voice available), or even a different language, e.g. using "nb" (Norwegian Bokmal) instead of "no" (Norwegian)".
+    "modelName": "A String", # Optional. The name of the model. If set, the service will choose the model matching the specified configuration.
     "name": "A String", # The name of the voice. If both the name and the gender are not set, the service will choose a voice based on the other parameters such as language_code.
     "ssmlGender": "A String", # The preferred gender of the voice. If not set, the service will choose a voice based on the other parameters such as language_code and name. Note that this is only a preference, not requirement; if a voice of the appropriate gender is not available, the synthesizer should substitute a voice with a different gender rather than failing the request.
     "voiceClone": { # The configuration of Voice Clone feature. # Optional. The configuration for a voice clone. If [VoiceCloneParams.voice_clone_key] is set, the service chooses the voice clone matching the specified configuration.
diff --git a/docs/dyn/texttospeech_v1beta1.projects.locations.html b/docs/dyn/texttospeech_v1beta1.projects.locations.html
index 6e2b94d882b..9c857c34a29 100644
--- a/docs/dyn/texttospeech_v1beta1.projects.locations.html
+++ b/docs/dyn/texttospeech_v1beta1.projects.locations.html
@@ -140,6 +140,7 @@ 
Method Details

       "reportedUsage": "A String", # Optional. Deprecated. The usage of the synthesized audio to be reported.
     },
     "languageCode": "A String", # Required. The language (and potentially also the region) of the voice expressed as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. "en-US". This should not include a script tag (e.g. use "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred from the input provided in the SynthesisInput. The TTS service will use this parameter to help choose an appropriate voice. Note that the TTS service may choose a voice with a slightly different language code than the one selected; it may substitute a different region (e.g. using en-US rather than en-CA if there isn't a Canadian voice available), or even a different language, e.g. using "nb" (Norwegian Bokmal) instead of "no" (Norwegian)".
+    "modelName": "A String", # Optional. The name of the model. If set, the service will choose the model matching the specified configuration.
     "name": "A String", # The name of the voice. If both the name and the gender are not set, the service will choose a voice based on the other parameters such as language_code.
     "ssmlGender": "A String", # The preferred gender of the voice. If not set, the service will choose a voice based on the other parameters such as language_code and name. Note that this is only a preference, not requirement; if a voice of the appropriate gender is not available, the synthesizer should substitute a voice with a different gender rather than failing the request.
     "voiceClone": { # The configuration of Voice Clone feature. # Optional. The configuration for a voice clone. If [VoiceCloneParams.voice_clone_key] is set, the service chooses the voice clone matching the specified configuration.
diff --git a/docs/dyn/texttospeech_v1beta1.text.html b/docs/dyn/texttospeech_v1beta1.text.html
index 1bd8a1f76f5..90384e54c33 100644
--- a/docs/dyn/texttospeech_v1beta1.text.html
+++ b/docs/dyn/texttospeech_v1beta1.text.html
@@ -139,6 +139,7 @@ 
Method Details

       "reportedUsage": "A String", # Optional. Deprecated. The usage of the synthesized audio to be reported.
     },
     "languageCode": "A String", # Required. The language (and potentially also the region) of the voice expressed as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. "en-US". This should not include a script tag (e.g. use "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred from the input provided in the SynthesisInput. The TTS service will use this parameter to help choose an appropriate voice. Note that the TTS service may choose a voice with a slightly different language code than the one selected; it may substitute a different region (e.g. using en-US rather than en-CA if there isn't a Canadian voice available), or even a different language, e.g. using "nb" (Norwegian Bokmal) instead of "no" (Norwegian)".
+    "modelName": "A String", # Optional. The name of the model. If set, the service will choose the model matching the specified configuration.
     "name": "A String", # The name of the voice. If both the name and the gender are not set, the service will choose a voice based on the other parameters such as language_code.
     "ssmlGender": "A String", # The preferred gender of the voice. If not set, the service will choose a voice based on the other parameters such as language_code and name. Note that this is only a preference, not requirement; if a voice of the appropriate gender is not available, the synthesizer should substitute a voice with a different gender rather than failing the request.
     "voiceClone": { # The configuration of Voice Clone feature. # Optional. The configuration for a voice clone. If [VoiceCloneParams.voice_clone_key] is set, the service chooses the voice clone matching the specified configuration.
diff --git a/googleapiclient/discovery_cache/documents/texttospeech.v1.json b/googleapiclient/discovery_cache/documents/texttospeech.v1.json
index 64283fa1556..790e8a879a2 100644
--- a/googleapiclient/discovery_cache/documents/texttospeech.v1.json
+++ b/googleapiclient/discovery_cache/documents/texttospeech.v1.json
@@ -318,7 +318,7 @@
 }
 }
 },
-"revision": "20250716",
+"revision": "20250805",
 "rootUrl": "https://texttospeech.googleapis.com/",
 "schemas": {
 "AdvancedVoiceOptions": {
@@ -791,6 +791,10 @@
 "description": "Required. The language (and potentially also the region) of the voice expressed as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. \"en-US\". This should not include a script tag (e.g. use \"cmn-cn\" rather than \"cmn-Hant-cn\"), because the script will be inferred from the input provided in the SynthesisInput. The TTS service will use this parameter to help choose an appropriate voice. Note that the TTS service may choose a voice with a slightly different language code than the one selected; it may substitute a different region (e.g. using en-US rather than en-CA if there isn't a Canadian voice available), or even a different language, e.g. using \"nb\" (Norwegian Bokmal) instead of \"no\" (Norwegian)\".",
 "type": "string"
 },
+"modelName": {
+"description": "Optional. The name of the model. If set, the service will choose the model matching the specified configuration.",
+"type": "string"
+},
 "name": {
 "description": "The name of the voice. If both the name and the gender are not set, the service will choose a voice based on the other parameters such as language_code.",
 "type": "string"
diff --git a/googleapiclient/discovery_cache/documents/texttospeech.v1beta1.json b/googleapiclient/discovery_cache/documents/texttospeech.v1beta1.json
index 1b2d35ca102..1c2cb52128d 100644
--- a/googleapiclient/discovery_cache/documents/texttospeech.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/texttospeech.v1beta1.json
@@ -261,7 +261,7 @@
 }
 }
 },
-"revision": "20250716",
+"revision": "20250805",
 "rootUrl": "https://texttospeech.googleapis.com/",
 "schemas": {
 "AdvancedVoiceOptions": {
@@ -766,6 +766,10 @@
 "description": "Required. The language (and potentially also the region) of the voice expressed as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. \"en-US\". This should not include a script tag (e.g. use \"cmn-cn\" rather than \"cmn-Hant-cn\"), because the script will be inferred from the input provided in the SynthesisInput. The TTS service will use this parameter to help choose an appropriate voice. Note that the TTS service may choose a voice with a slightly different language code than the one selected; it may substitute a different region (e.g. using en-US rather than en-CA if there isn't a Canadian voice available), or even a different language, e.g. using \"nb\" (Norwegian Bokmal) instead of \"no\" (Norwegian)\".",
 "type": "string"
 },
+"modelName": {
+"description": "Optional. The name of the model. If set, the service will choose the model matching the specified configuration.",
+"type": "string"
+},
 "name": {
 "description": "The name of the voice. If both the name and the gender are not set, the service will choose a voice based on the other parameters such as language_code.",
 "type": "string"

From 54fed5571c6171c445b82fb1757d0f4f439bf939 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:01 +0000
Subject: [PATCH 31/32] feat(walletobjects): update the api

#### walletobjects:v1

The following keys were added:
- schemas.Image.properties.privateImageId.type (Total Keys: 1)
- schemas.UploadPrivateImageRequest (Total Keys: 2)
- schemas.UploadPrivateImageResponse (Total Keys: 3)
---
 .../walletobjects_v1.eventticketclass.html    | 243 +++++---
 .../walletobjects_v1.eventticketobject.html   | 450 +++++++++-----
 docs/dyn/walletobjects_v1.flightclass.html    | 351 +++++++----
 docs/dyn/walletobjects_v1.flightobject.html   | 567 ++++++++++++------
 docs/dyn/walletobjects_v1.genericclass.html   | 135 +++--
 docs/dyn/walletobjects_v1.genericobject.html  | 216 ++++---
 docs/dyn/walletobjects_v1.giftcardclass.html  | 243 +++++---
 docs/dyn/walletobjects_v1.giftcardobject.html | 405 ++++++++-----
 docs/dyn/walletobjects_v1.jwt.html            | 507 ++++++++++------
 docs/dyn/walletobjects_v1.loyaltyclass.html   | 243 +++++---
 docs/dyn/walletobjects_v1.loyaltyobject.html  | 450 +++++++++-----
 docs/dyn/walletobjects_v1.offerclass.html     | 243 +++++---
 docs/dyn/walletobjects_v1.offerobject.html    | 405 ++++++++-----
 docs/dyn/walletobjects_v1.transitclass.html   | 270 ++++++---
 docs/dyn/walletobjects_v1.transitobject.html  | 432 ++++++++-----
 .../documents/walletobjects.v1.json           |  25 +-
 16 files changed, 3463 insertions(+), 1722 deletions(-)

diff --git a/docs/dyn/walletobjects_v1.eventticketclass.html b/docs/dyn/walletobjects_v1.eventticketclass.html
index 59be133a298..e5febe59f9e 100644
--- a/docs/dyn/walletobjects_v1.eventticketclass.html
+++ b/docs/dyn/walletobjects_v1.eventticketclass.html
@@ -184,7 +184,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -292,7 +293,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -385,7 +387,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -828,7 +831,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -891,7 +895,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1022,7 +1027,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1197,7 +1203,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1284,7 +1291,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1321,7 +1329,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1385,7 +1394,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1493,7 +1503,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1586,7 +1597,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2029,7 +2041,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2092,7 +2105,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2223,7 +2237,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2398,7 +2413,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2485,7 +2501,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2522,7 +2539,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2574,7 +2592,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2682,7 +2701,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2775,7 +2795,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3218,7 +3239,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3281,7 +3303,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3412,7 +3435,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3587,7 +3611,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3674,7 +3699,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3711,7 +3737,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3762,7 +3789,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3870,7 +3898,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3963,7 +3992,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4406,7 +4436,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4469,7 +4500,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4600,7 +4632,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4775,7 +4808,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4862,7 +4896,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4899,7 +4934,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4966,7 +5002,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5074,7 +5111,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5167,7 +5205,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5610,7 +5649,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5673,7 +5713,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5804,7 +5845,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5979,7 +6021,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6066,7 +6109,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6103,7 +6147,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6158,7 +6203,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6266,7 +6312,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6359,7 +6406,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6802,7 +6850,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6865,7 +6914,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6996,7 +7046,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7171,7 +7222,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7258,7 +7310,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7295,7 +7348,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7346,7 +7400,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7454,7 +7509,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7547,7 +7603,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7990,7 +8047,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8053,7 +8111,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8184,7 +8243,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8359,7 +8419,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8446,7 +8507,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8483,7 +8545,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8536,7 +8599,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8644,7 +8708,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8737,7 +8802,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9180,7 +9246,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9243,7 +9310,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9374,7 +9442,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9549,7 +9618,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9636,7 +9706,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9673,7 +9744,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9724,7 +9796,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9832,7 +9905,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9925,7 +9999,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10368,7 +10443,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10431,7 +10507,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10562,7 +10639,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10737,7 +10815,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10824,7 +10903,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10861,7 +10941,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.eventticketobject.html b/docs/dyn/walletobjects_v1.eventticketobject.html
index 72df5f29cff..64d54982623 100644
--- a/docs/dyn/walletobjects_v1.eventticketobject.html
+++ b/docs/dyn/walletobjects_v1.eventticketobject.html
@@ -186,7 +186,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -294,7 +295,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -387,7 +389,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -507,7 +510,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -615,7 +619,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -708,7 +713,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1151,7 +1157,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1214,7 +1221,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1345,7 +1353,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1520,7 +1529,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1607,7 +1617,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1644,7 +1655,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1694,7 +1706,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1736,7 +1749,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2123,7 +2137,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2202,7 +2217,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2310,7 +2326,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2403,7 +2420,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2523,7 +2541,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2631,7 +2650,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2724,7 +2744,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3167,7 +3188,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3230,7 +3252,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3361,7 +3384,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3536,7 +3560,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3623,7 +3648,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3660,7 +3686,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3710,7 +3737,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3752,7 +3780,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4139,7 +4168,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4206,7 +4236,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4314,7 +4345,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4407,7 +4439,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4527,7 +4560,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4635,7 +4669,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4728,7 +4763,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5171,7 +5207,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5234,7 +5271,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5365,7 +5403,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5540,7 +5579,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5627,7 +5667,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5664,7 +5705,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5714,7 +5756,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5756,7 +5799,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6143,7 +6187,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6209,7 +6254,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6317,7 +6363,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6410,7 +6457,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6530,7 +6578,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6638,7 +6687,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6731,7 +6781,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7174,7 +7225,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7237,7 +7289,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7368,7 +7421,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7543,7 +7597,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7630,7 +7685,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7667,7 +7723,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7717,7 +7774,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7759,7 +7817,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8146,7 +8205,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8228,7 +8288,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8336,7 +8397,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8429,7 +8491,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8549,7 +8612,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8657,7 +8721,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8750,7 +8815,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9193,7 +9259,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9256,7 +9323,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9387,7 +9455,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9562,7 +9631,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9649,7 +9719,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9686,7 +9757,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9736,7 +9808,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9778,7 +9851,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10165,7 +10239,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10254,7 +10329,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10362,7 +10438,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10455,7 +10532,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10575,7 +10653,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10683,7 +10762,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10776,7 +10856,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11219,7 +11300,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11282,7 +11364,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11413,7 +11496,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11588,7 +11672,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11675,7 +11760,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11712,7 +11798,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11762,7 +11849,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11804,7 +11892,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12191,7 +12280,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12259,7 +12349,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12367,7 +12458,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12460,7 +12552,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12580,7 +12673,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12688,7 +12782,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12781,7 +12876,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13224,7 +13320,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13287,7 +13384,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13418,7 +13516,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13593,7 +13692,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13680,7 +13780,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13717,7 +13818,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13767,7 +13869,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13809,7 +13912,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14196,7 +14300,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14262,7 +14367,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14370,7 +14476,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14463,7 +14570,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14583,7 +14691,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14691,7 +14800,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14784,7 +14894,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15227,7 +15338,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15290,7 +15402,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15421,7 +15534,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15596,7 +15710,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15683,7 +15798,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15720,7 +15836,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15770,7 +15887,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15812,7 +15930,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16199,7 +16318,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16267,7 +16387,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16375,7 +16496,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16468,7 +16590,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16588,7 +16711,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16696,7 +16820,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16789,7 +16914,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17232,7 +17358,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17295,7 +17422,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17426,7 +17554,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17601,7 +17730,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17688,7 +17818,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17725,7 +17856,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17775,7 +17907,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17817,7 +17950,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18204,7 +18338,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18270,7 +18405,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18378,7 +18514,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18471,7 +18608,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18591,7 +18729,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18699,7 +18838,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18792,7 +18932,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19235,7 +19376,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19298,7 +19440,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19429,7 +19572,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19604,7 +19748,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19691,7 +19836,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19728,7 +19874,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19778,7 +19925,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19820,7 +19968,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20207,7 +20356,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.flightclass.html b/docs/dyn/walletobjects_v1.flightclass.html
index 36d34580bfd..81b34dbf261 100644
--- a/docs/dyn/walletobjects_v1.flightclass.html
+++ b/docs/dyn/walletobjects_v1.flightclass.html
@@ -184,7 +184,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -292,7 +293,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -385,7 +387,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -726,7 +729,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -763,7 +767,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -818,7 +823,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -860,7 +866,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -897,7 +904,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -952,7 +960,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -993,7 +1002,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1056,7 +1066,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1350,7 +1361,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1404,7 +1416,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1468,7 +1481,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1576,7 +1590,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1669,7 +1684,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2010,7 +2026,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2047,7 +2064,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2102,7 +2120,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2144,7 +2163,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2181,7 +2201,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2236,7 +2257,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2277,7 +2299,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2340,7 +2363,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2634,7 +2658,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2688,7 +2713,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2740,7 +2766,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2848,7 +2875,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2941,7 +2969,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3282,7 +3311,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3319,7 +3349,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3374,7 +3405,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3416,7 +3448,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3453,7 +3486,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3508,7 +3542,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3549,7 +3584,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3612,7 +3648,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3906,7 +3943,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3960,7 +3998,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4011,7 +4050,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4119,7 +4159,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4212,7 +4253,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4553,7 +4595,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4590,7 +4633,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4645,7 +4689,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4687,7 +4732,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4724,7 +4770,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4779,7 +4826,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4820,7 +4868,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4883,7 +4932,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5177,7 +5227,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5231,7 +5282,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5298,7 +5350,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5406,7 +5459,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5499,7 +5553,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5840,7 +5895,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5877,7 +5933,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5932,7 +5989,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5974,7 +6032,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6011,7 +6070,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6066,7 +6126,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6107,7 +6168,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6170,7 +6232,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6464,7 +6527,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6518,7 +6582,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6573,7 +6638,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6681,7 +6747,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6774,7 +6841,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7115,7 +7183,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7152,7 +7221,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7207,7 +7277,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7249,7 +7320,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7286,7 +7358,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7341,7 +7414,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7382,7 +7456,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7445,7 +7520,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7739,7 +7815,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7793,7 +7870,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7844,7 +7922,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7952,7 +8031,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8045,7 +8125,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8386,7 +8467,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8423,7 +8505,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8478,7 +8561,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8520,7 +8604,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8557,7 +8642,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8612,7 +8698,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8653,7 +8740,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8716,7 +8804,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9010,7 +9099,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9064,7 +9154,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9117,7 +9208,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9225,7 +9317,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9318,7 +9411,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9659,7 +9753,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9696,7 +9791,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9751,7 +9847,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9793,7 +9890,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9830,7 +9928,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9885,7 +9984,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9926,7 +10026,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9989,7 +10090,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10283,7 +10385,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10337,7 +10440,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10388,7 +10492,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10496,7 +10601,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10589,7 +10695,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10930,7 +11037,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10967,7 +11075,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11022,7 +11131,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11064,7 +11174,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11101,7 +11212,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11156,7 +11268,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11197,7 +11310,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11260,7 +11374,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11554,7 +11669,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11608,7 +11724,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.flightobject.html b/docs/dyn/walletobjects_v1.flightobject.html
index 654e5e044be..0967ee63bf0 100644
--- a/docs/dyn/walletobjects_v1.flightobject.html
+++ b/docs/dyn/walletobjects_v1.flightobject.html
@@ -183,7 +183,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -291,7 +292,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -384,7 +386,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -503,7 +506,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -565,7 +569,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -673,7 +678,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -766,7 +772,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1107,7 +1114,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1144,7 +1152,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1199,7 +1208,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1241,7 +1251,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1278,7 +1289,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1333,7 +1345,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1374,7 +1387,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1437,7 +1451,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1731,7 +1746,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1785,7 +1801,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1830,7 +1847,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1872,7 +1890,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2117,7 +2136,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2234,7 +2254,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2313,7 +2334,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2421,7 +2443,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2514,7 +2537,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2633,7 +2657,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2695,7 +2720,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2803,7 +2829,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2896,7 +2923,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3237,7 +3265,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3274,7 +3303,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3329,7 +3359,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3371,7 +3402,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3408,7 +3440,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3463,7 +3496,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3504,7 +3538,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3567,7 +3602,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3861,7 +3897,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3915,7 +3952,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3960,7 +3998,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4002,7 +4041,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4247,7 +4287,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4364,7 +4405,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4431,7 +4473,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4539,7 +4582,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4632,7 +4676,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4751,7 +4796,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4813,7 +4859,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4921,7 +4968,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5014,7 +5062,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5355,7 +5404,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5392,7 +5442,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5447,7 +5498,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5489,7 +5541,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5526,7 +5579,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5581,7 +5635,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5622,7 +5677,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5685,7 +5741,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5979,7 +6036,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6033,7 +6091,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6078,7 +6137,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6120,7 +6180,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6365,7 +6426,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6482,7 +6544,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6548,7 +6611,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6656,7 +6720,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6749,7 +6814,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6868,7 +6934,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6930,7 +6997,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7038,7 +7106,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7131,7 +7200,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7472,7 +7542,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7509,7 +7580,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7564,7 +7636,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7606,7 +7679,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7643,7 +7717,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7698,7 +7773,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7739,7 +7815,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7802,7 +7879,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8096,7 +8174,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8150,7 +8229,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8195,7 +8275,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8237,7 +8318,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8482,7 +8564,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8599,7 +8682,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8681,7 +8765,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8789,7 +8874,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8882,7 +8968,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9001,7 +9088,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9063,7 +9151,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9171,7 +9260,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9264,7 +9354,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9605,7 +9696,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9642,7 +9734,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9697,7 +9790,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9739,7 +9833,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9776,7 +9871,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9831,7 +9927,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9872,7 +9969,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9935,7 +10033,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10229,7 +10328,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10283,7 +10383,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10328,7 +10429,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10370,7 +10472,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10615,7 +10718,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10732,7 +10836,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10802,7 +10907,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10910,7 +11016,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11003,7 +11110,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11122,7 +11230,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11184,7 +11293,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11292,7 +11402,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11385,7 +11496,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11726,7 +11838,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11763,7 +11876,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11818,7 +11932,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11860,7 +11975,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11897,7 +12013,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11952,7 +12069,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11993,7 +12111,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12056,7 +12175,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12350,7 +12470,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12404,7 +12525,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12449,7 +12571,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12491,7 +12614,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12736,7 +12860,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12853,7 +12978,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12919,7 +13045,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13027,7 +13154,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13120,7 +13248,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13239,7 +13368,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13301,7 +13431,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13409,7 +13540,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13502,7 +13634,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13843,7 +13976,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13880,7 +14014,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13935,7 +14070,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13977,7 +14113,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14014,7 +14151,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14069,7 +14207,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14110,7 +14249,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14173,7 +14313,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14467,7 +14608,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14521,7 +14663,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14566,7 +14709,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14608,7 +14752,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14853,7 +14998,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14970,7 +15116,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15038,7 +15185,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15146,7 +15294,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15239,7 +15388,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15358,7 +15508,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15420,7 +15571,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15528,7 +15680,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15621,7 +15774,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15962,7 +16116,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15999,7 +16154,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16054,7 +16210,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16096,7 +16253,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16133,7 +16291,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16188,7 +16347,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16229,7 +16389,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16292,7 +16453,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16586,7 +16748,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16640,7 +16803,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16685,7 +16849,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16727,7 +16892,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16972,7 +17138,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17089,7 +17256,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17155,7 +17323,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17263,7 +17432,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17356,7 +17526,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17475,7 +17646,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17537,7 +17709,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17645,7 +17818,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17738,7 +17912,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18079,7 +18254,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18116,7 +18292,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18171,7 +18348,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18213,7 +18391,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18250,7 +18429,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18305,7 +18485,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18346,7 +18527,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18409,7 +18591,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18703,7 +18886,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18757,7 +18941,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18802,7 +18987,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18844,7 +19030,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19089,7 +19276,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19206,7 +19394,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.genericclass.html b/docs/dyn/walletobjects_v1.genericclass.html
index 128df2d9762..21df093ff0f 100644
--- a/docs/dyn/walletobjects_v1.genericclass.html
+++ b/docs/dyn/walletobjects_v1.genericclass.html
@@ -183,7 +183,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -291,7 +292,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -384,7 +386,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -700,7 +703,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -894,7 +898,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -973,7 +978,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1081,7 +1087,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1174,7 +1181,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1490,7 +1498,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1684,7 +1693,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1751,7 +1761,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1859,7 +1870,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1952,7 +1964,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2268,7 +2281,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2462,7 +2476,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2528,7 +2543,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2636,7 +2652,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2729,7 +2746,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3045,7 +3063,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3239,7 +3258,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3321,7 +3341,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3429,7 +3450,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3522,7 +3544,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3838,7 +3861,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4032,7 +4056,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4102,7 +4127,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4210,7 +4236,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4303,7 +4330,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4619,7 +4647,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4813,7 +4842,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4879,7 +4909,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4987,7 +5018,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5080,7 +5112,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5396,7 +5429,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5590,7 +5624,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5658,7 +5693,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5766,7 +5802,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5859,7 +5896,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6175,7 +6213,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6369,7 +6408,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6435,7 +6475,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6543,7 +6584,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6636,7 +6678,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6952,7 +6995,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7146,7 +7190,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.genericobject.html b/docs/dyn/walletobjects_v1.genericobject.html
index dbe90cc9a58..641a00eb6ff 100644
--- a/docs/dyn/walletobjects_v1.genericobject.html
+++ b/docs/dyn/walletobjects_v1.genericobject.html
@@ -183,7 +183,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -291,7 +292,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -384,7 +386,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -536,7 +539,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -578,7 +582,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -645,7 +650,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -886,7 +892,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -938,7 +945,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1001,7 +1009,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1109,7 +1118,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1202,7 +1212,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1354,7 +1365,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1396,7 +1408,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1463,7 +1476,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1704,7 +1718,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1756,7 +1771,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1807,7 +1823,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1915,7 +1932,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2008,7 +2026,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2160,7 +2179,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2202,7 +2222,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2269,7 +2290,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2510,7 +2532,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2562,7 +2585,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2612,7 +2636,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2720,7 +2745,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2813,7 +2839,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2965,7 +2992,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3007,7 +3035,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3074,7 +3103,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3315,7 +3345,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3367,7 +3398,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3433,7 +3465,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3541,7 +3574,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3634,7 +3668,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3786,7 +3821,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3828,7 +3864,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3895,7 +3932,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4136,7 +4174,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4188,7 +4227,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4242,7 +4282,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4350,7 +4391,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4443,7 +4485,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4595,7 +4638,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4637,7 +4681,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4704,7 +4749,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4945,7 +4991,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4997,7 +5044,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5047,7 +5095,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5155,7 +5204,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5248,7 +5298,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5400,7 +5451,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5442,7 +5494,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5509,7 +5562,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5750,7 +5804,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5802,7 +5857,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5854,7 +5910,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5962,7 +6019,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6055,7 +6113,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6207,7 +6266,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6249,7 +6309,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6316,7 +6377,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6557,7 +6619,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6609,7 +6672,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6659,7 +6723,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6767,7 +6832,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6860,7 +6926,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7012,7 +7079,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7054,7 +7122,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7121,7 +7190,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7362,7 +7432,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7414,7 +7485,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.giftcardclass.html b/docs/dyn/walletobjects_v1.giftcardclass.html
index 219124aa443..3ca673c1d3b 100644
--- a/docs/dyn/walletobjects_v1.giftcardclass.html
+++ b/docs/dyn/walletobjects_v1.giftcardclass.html
@@ -185,7 +185,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -293,7 +294,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -386,7 +388,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -701,7 +704,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -764,7 +768,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1013,7 +1018,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1129,7 +1135,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1183,7 +1190,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1220,7 +1228,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1285,7 +1294,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1393,7 +1403,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1486,7 +1497,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1801,7 +1813,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1864,7 +1877,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2113,7 +2127,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2229,7 +2244,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2283,7 +2299,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2320,7 +2337,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2373,7 +2391,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2481,7 +2500,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2574,7 +2594,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2889,7 +2910,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2952,7 +2974,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3201,7 +3224,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3317,7 +3341,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3371,7 +3396,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3408,7 +3434,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3460,7 +3487,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3568,7 +3596,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3661,7 +3690,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3976,7 +4006,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4039,7 +4070,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4288,7 +4320,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4404,7 +4437,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4458,7 +4492,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4495,7 +4530,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4563,7 +4599,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4671,7 +4708,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4764,7 +4802,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5079,7 +5118,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5142,7 +5182,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5391,7 +5432,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5507,7 +5549,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5561,7 +5604,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5598,7 +5642,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5654,7 +5699,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5762,7 +5808,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5855,7 +5902,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6170,7 +6218,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6233,7 +6282,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6482,7 +6532,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6598,7 +6649,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6652,7 +6704,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6689,7 +6742,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6741,7 +6795,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6849,7 +6904,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6942,7 +6998,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7257,7 +7314,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7320,7 +7378,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7569,7 +7628,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7685,7 +7745,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7739,7 +7800,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7776,7 +7838,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7830,7 +7893,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7938,7 +8002,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8031,7 +8096,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8346,7 +8412,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8409,7 +8476,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8658,7 +8726,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8774,7 +8843,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8828,7 +8898,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8865,7 +8936,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8917,7 +8989,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9025,7 +9098,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9118,7 +9192,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9433,7 +9508,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9496,7 +9572,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9745,7 +9822,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9861,7 +9939,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9915,7 +9994,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9952,7 +10032,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.giftcardobject.html b/docs/dyn/walletobjects_v1.giftcardobject.html
index 1ab3f7d7433..9d80c4ff6ef 100644
--- a/docs/dyn/walletobjects_v1.giftcardobject.html
+++ b/docs/dyn/walletobjects_v1.giftcardobject.html
@@ -183,7 +183,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -291,7 +292,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -384,7 +386,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -514,7 +517,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -622,7 +626,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -715,7 +720,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1030,7 +1036,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1093,7 +1100,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1342,7 +1350,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1458,7 +1467,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1512,7 +1522,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1549,7 +1560,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1595,7 +1607,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1636,7 +1649,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1937,7 +1951,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2016,7 +2031,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2124,7 +2140,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2217,7 +2234,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2347,7 +2365,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2455,7 +2474,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2548,7 +2568,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2863,7 +2884,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2926,7 +2948,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3175,7 +3198,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3291,7 +3315,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3345,7 +3370,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3382,7 +3408,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3428,7 +3455,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3469,7 +3497,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3770,7 +3799,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3837,7 +3867,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3945,7 +3976,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4038,7 +4070,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4168,7 +4201,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4276,7 +4310,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4369,7 +4404,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4684,7 +4720,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4747,7 +4784,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4996,7 +5034,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5112,7 +5151,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5166,7 +5206,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5203,7 +5244,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5249,7 +5291,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5290,7 +5333,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5591,7 +5635,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5657,7 +5702,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5765,7 +5811,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5858,7 +5905,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5988,7 +6036,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6096,7 +6145,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6189,7 +6239,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6504,7 +6555,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6567,7 +6619,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6816,7 +6869,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6932,7 +6986,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6986,7 +7041,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7023,7 +7079,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7069,7 +7126,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7110,7 +7168,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7411,7 +7470,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7493,7 +7553,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7601,7 +7662,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7694,7 +7756,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7824,7 +7887,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7932,7 +7996,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8025,7 +8090,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8340,7 +8406,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8403,7 +8470,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8652,7 +8720,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8768,7 +8837,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8822,7 +8892,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8859,7 +8930,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8905,7 +8977,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8946,7 +9019,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9247,7 +9321,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9317,7 +9392,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9425,7 +9501,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9518,7 +9595,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9648,7 +9726,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9756,7 +9835,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9849,7 +9929,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10164,7 +10245,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10227,7 +10309,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10476,7 +10559,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10592,7 +10676,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10646,7 +10731,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10683,7 +10769,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10729,7 +10816,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10770,7 +10858,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11071,7 +11160,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11137,7 +11227,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11245,7 +11336,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11338,7 +11430,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11468,7 +11561,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11576,7 +11670,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11669,7 +11764,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11984,7 +12080,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12047,7 +12144,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12296,7 +12394,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12412,7 +12511,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12466,7 +12566,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12503,7 +12604,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12549,7 +12651,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12590,7 +12693,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12891,7 +12995,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12959,7 +13064,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13067,7 +13173,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13160,7 +13267,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13290,7 +13398,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13398,7 +13507,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13491,7 +13601,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13806,7 +13917,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13869,7 +13981,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14118,7 +14231,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14234,7 +14348,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14288,7 +14403,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14325,7 +14441,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14371,7 +14488,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14412,7 +14530,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14713,7 +14832,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14779,7 +14899,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14887,7 +15008,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14980,7 +15102,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15110,7 +15233,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15218,7 +15342,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15311,7 +15436,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15626,7 +15752,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15689,7 +15816,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15938,7 +16066,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16054,7 +16183,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16108,7 +16238,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16145,7 +16276,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16191,7 +16323,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16232,7 +16365,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16533,7 +16667,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.jwt.html b/docs/dyn/walletobjects_v1.jwt.html
index 8ba42ec39be..9a33417f6cf 100644
--- a/docs/dyn/walletobjects_v1.jwt.html
+++ b/docs/dyn/walletobjects_v1.jwt.html
@@ -130,7 +130,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -238,7 +239,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -331,7 +333,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -774,7 +777,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -837,7 +841,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -968,7 +973,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1143,7 +1149,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1230,7 +1237,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1267,7 +1275,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1310,7 +1319,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1418,7 +1428,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1511,7 +1522,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1631,7 +1643,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1739,7 +1752,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1832,7 +1846,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2275,7 +2290,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2338,7 +2354,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2469,7 +2486,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2644,7 +2662,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2731,7 +2750,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2768,7 +2788,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2818,7 +2839,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2860,7 +2882,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3247,7 +3270,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3307,7 +3331,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3415,7 +3440,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3508,7 +3534,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3849,7 +3876,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3886,7 +3914,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3941,7 +3970,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3983,7 +4013,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4020,7 +4051,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4075,7 +4107,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4116,7 +4149,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4179,7 +4213,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4473,7 +4508,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4527,7 +4563,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4570,7 +4607,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4678,7 +4716,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4771,7 +4810,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4890,7 +4930,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4952,7 +4993,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5060,7 +5102,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5153,7 +5196,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5494,7 +5538,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5531,7 +5576,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5586,7 +5632,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5628,7 +5675,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5665,7 +5713,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5720,7 +5769,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5761,7 +5811,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5824,7 +5875,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6118,7 +6170,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6172,7 +6225,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6217,7 +6271,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6259,7 +6314,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6504,7 +6560,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6621,7 +6678,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6680,7 +6738,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6788,7 +6847,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6881,7 +6941,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7197,7 +7258,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7391,7 +7453,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7450,7 +7513,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7558,7 +7622,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7651,7 +7716,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7803,7 +7869,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7845,7 +7912,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7912,7 +7980,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8153,7 +8222,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8205,7 +8275,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8250,7 +8321,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8358,7 +8430,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8451,7 +8524,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8766,7 +8840,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8829,7 +8904,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9078,7 +9154,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9194,7 +9271,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9248,7 +9326,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9285,7 +9364,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9328,7 +9408,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9436,7 +9517,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9529,7 +9611,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9659,7 +9742,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9767,7 +9851,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9860,7 +9945,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10175,7 +10261,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10238,7 +10325,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10487,7 +10575,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10603,7 +10692,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10657,7 +10747,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10694,7 +10785,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10740,7 +10832,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10781,7 +10874,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11082,7 +11176,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11144,7 +11239,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11252,7 +11348,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11345,7 +11442,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11710,7 +11808,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11773,7 +11872,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12065,7 +12165,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12186,7 +12287,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12240,7 +12342,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12277,7 +12380,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12322,7 +12426,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12430,7 +12535,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12523,7 +12629,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12645,7 +12752,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12753,7 +12861,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12846,7 +12955,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13211,7 +13321,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13274,7 +13385,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13566,7 +13678,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13687,7 +13800,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13741,7 +13855,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13778,7 +13893,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13823,7 +13939,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13864,7 +13981,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14223,7 +14341,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14283,7 +14402,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14391,7 +14511,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14484,7 +14605,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14820,7 +14942,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14883,7 +15006,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15196,7 +15320,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15265,7 +15390,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15319,7 +15445,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15356,7 +15483,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15399,7 +15527,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15507,7 +15636,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15600,7 +15730,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15720,7 +15851,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15828,7 +15960,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15921,7 +16054,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16257,7 +16391,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16320,7 +16455,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16633,7 +16769,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16702,7 +16839,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16756,7 +16894,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16793,7 +16932,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16838,7 +16978,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16879,7 +17020,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17179,7 +17321,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17243,7 +17386,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17351,7 +17495,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17444,7 +17589,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18043,7 +18189,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18106,7 +18253,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18237,7 +18385,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18425,7 +18574,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18479,7 +18629,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18516,7 +18667,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18553,7 +18705,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18599,7 +18752,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18707,7 +18861,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18800,7 +18955,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18924,7 +19080,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19032,7 +19189,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19125,7 +19283,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19724,7 +19883,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19787,7 +19947,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19918,7 +20079,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20106,7 +20268,8 @@ 
Method Details

                   ],
                 },
                 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-                "sourceUri": { # The URI for the image.
+                "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+                "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                   "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                   "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                     "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20160,7 +20323,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20197,7 +20361,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20234,7 +20399,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20313,7 +20479,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20355,7 +20522,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -21069,7 +21237,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.loyaltyclass.html b/docs/dyn/walletobjects_v1.loyaltyclass.html
index d00cea2aaa2..4b7e66ad4f7 100644
--- a/docs/dyn/walletobjects_v1.loyaltyclass.html
+++ b/docs/dyn/walletobjects_v1.loyaltyclass.html
@@ -186,7 +186,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -294,7 +295,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -387,7 +389,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -752,7 +755,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -815,7 +819,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1107,7 +1112,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1228,7 +1234,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1282,7 +1289,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1319,7 +1327,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1385,7 +1394,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1493,7 +1503,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1586,7 +1597,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1951,7 +1963,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2014,7 +2027,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2306,7 +2320,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2427,7 +2442,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2481,7 +2497,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2518,7 +2535,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2572,7 +2590,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2680,7 +2699,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2773,7 +2793,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3138,7 +3159,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3201,7 +3223,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3493,7 +3516,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3614,7 +3638,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3668,7 +3693,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3705,7 +3731,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3758,7 +3785,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3866,7 +3894,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3959,7 +3988,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4324,7 +4354,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4387,7 +4418,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4679,7 +4711,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4800,7 +4833,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4854,7 +4888,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4891,7 +4926,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4960,7 +4996,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5068,7 +5105,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5161,7 +5199,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5526,7 +5565,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5589,7 +5629,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5881,7 +5922,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6002,7 +6044,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6056,7 +6099,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6093,7 +6137,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6150,7 +6195,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6258,7 +6304,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6351,7 +6398,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6716,7 +6764,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6779,7 +6828,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7071,7 +7121,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7192,7 +7243,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7246,7 +7298,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7283,7 +7336,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7336,7 +7390,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7444,7 +7499,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7537,7 +7593,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7902,7 +7959,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7965,7 +8023,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8257,7 +8316,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8378,7 +8438,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8432,7 +8493,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8469,7 +8531,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8524,7 +8587,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8632,7 +8696,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8725,7 +8790,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9090,7 +9156,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9153,7 +9220,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9445,7 +9513,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9566,7 +9635,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9620,7 +9690,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9657,7 +9728,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9710,7 +9782,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9818,7 +9891,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9911,7 +9985,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10276,7 +10351,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10339,7 +10415,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10631,7 +10708,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10752,7 +10830,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10806,7 +10885,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10843,7 +10923,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.loyaltyobject.html b/docs/dyn/walletobjects_v1.loyaltyobject.html
index 8c43988b4f6..b91df8da793 100644
--- a/docs/dyn/walletobjects_v1.loyaltyobject.html
+++ b/docs/dyn/walletobjects_v1.loyaltyobject.html
@@ -188,7 +188,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -296,7 +297,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -389,7 +391,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -511,7 +514,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -619,7 +623,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -712,7 +717,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1077,7 +1083,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1140,7 +1147,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1432,7 +1440,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1553,7 +1562,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1607,7 +1617,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1644,7 +1655,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1689,7 +1701,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1730,7 +1743,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2089,7 +2103,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2170,7 +2185,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2278,7 +2294,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2371,7 +2388,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2493,7 +2511,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2601,7 +2620,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2694,7 +2714,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3059,7 +3080,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3122,7 +3144,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3414,7 +3437,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3535,7 +3559,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3589,7 +3614,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3626,7 +3652,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3671,7 +3698,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3712,7 +3740,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4071,7 +4100,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4140,7 +4170,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4248,7 +4279,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4341,7 +4373,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4463,7 +4496,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4571,7 +4605,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4664,7 +4699,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5029,7 +5065,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5092,7 +5129,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5384,7 +5422,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5505,7 +5544,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5559,7 +5599,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5596,7 +5637,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5641,7 +5683,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5682,7 +5725,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6041,7 +6085,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6109,7 +6154,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6217,7 +6263,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6310,7 +6357,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6432,7 +6480,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6540,7 +6589,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6633,7 +6683,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6998,7 +7049,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7061,7 +7113,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7353,7 +7406,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7474,7 +7528,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7528,7 +7583,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7565,7 +7621,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7610,7 +7667,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7651,7 +7709,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8010,7 +8069,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8094,7 +8154,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8202,7 +8263,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8295,7 +8357,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8417,7 +8480,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8525,7 +8589,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8618,7 +8683,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8983,7 +9049,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9046,7 +9113,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9338,7 +9406,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9459,7 +9528,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9513,7 +9583,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9550,7 +9621,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9595,7 +9667,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9636,7 +9709,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9995,7 +10069,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10086,7 +10161,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10194,7 +10270,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10287,7 +10364,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10409,7 +10487,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10517,7 +10596,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10610,7 +10690,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10975,7 +11056,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11038,7 +11120,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11330,7 +11413,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11451,7 +11535,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11505,7 +11590,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11542,7 +11628,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11587,7 +11674,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11628,7 +11716,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11987,7 +12076,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12057,7 +12147,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12165,7 +12256,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12258,7 +12350,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12380,7 +12473,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12488,7 +12582,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12581,7 +12676,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12946,7 +13042,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13009,7 +13106,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13301,7 +13399,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13422,7 +13521,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13476,7 +13576,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13513,7 +13614,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13558,7 +13660,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13599,7 +13702,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13958,7 +14062,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14026,7 +14131,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14134,7 +14240,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14227,7 +14334,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14349,7 +14457,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14457,7 +14566,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14550,7 +14660,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14915,7 +15026,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14978,7 +15090,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15270,7 +15383,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15391,7 +15505,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15445,7 +15560,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15482,7 +15598,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15527,7 +15644,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15568,7 +15686,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15927,7 +16046,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15997,7 +16117,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16105,7 +16226,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16198,7 +16320,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16320,7 +16443,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16428,7 +16552,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16521,7 +16646,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16886,7 +17012,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16949,7 +17076,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17241,7 +17369,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17362,7 +17491,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17416,7 +17546,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17453,7 +17584,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17498,7 +17630,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17539,7 +17672,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17898,7 +18032,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17966,7 +18101,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18074,7 +18210,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18167,7 +18304,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18289,7 +18427,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18397,7 +18536,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18490,7 +18630,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18855,7 +18996,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18918,7 +19060,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19210,7 +19353,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19331,7 +19475,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19385,7 +19530,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19422,7 +19568,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19467,7 +19614,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19508,7 +19656,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19867,7 +20016,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.offerclass.html b/docs/dyn/walletobjects_v1.offerclass.html
index 3b0a5bcf099..59d94aed838 100644
--- a/docs/dyn/walletobjects_v1.offerclass.html
+++ b/docs/dyn/walletobjects_v1.offerclass.html
@@ -184,7 +184,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -292,7 +293,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -385,7 +387,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -721,7 +724,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -784,7 +788,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1097,7 +1102,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1166,7 +1172,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1220,7 +1227,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1257,7 +1265,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1321,7 +1330,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1429,7 +1439,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1522,7 +1533,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1858,7 +1870,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1921,7 +1934,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2234,7 +2248,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2303,7 +2318,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2357,7 +2373,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2394,7 +2411,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2446,7 +2464,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2554,7 +2573,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2647,7 +2667,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2983,7 +3004,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3046,7 +3068,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3359,7 +3382,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3428,7 +3452,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3482,7 +3507,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3519,7 +3545,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3570,7 +3597,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3678,7 +3706,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3771,7 +3800,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4107,7 +4137,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4170,7 +4201,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4483,7 +4515,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4552,7 +4585,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4606,7 +4640,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4643,7 +4678,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4710,7 +4746,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4818,7 +4855,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4911,7 +4949,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5247,7 +5286,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5310,7 +5350,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5623,7 +5664,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5692,7 +5734,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5746,7 +5789,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5783,7 +5827,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5838,7 +5883,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5946,7 +5992,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6039,7 +6086,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6375,7 +6423,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6438,7 +6487,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6751,7 +6801,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6820,7 +6871,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6874,7 +6926,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6911,7 +6964,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6962,7 +7016,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7070,7 +7125,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7163,7 +7219,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7499,7 +7556,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7562,7 +7620,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7875,7 +7934,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7944,7 +8004,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7998,7 +8059,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8035,7 +8097,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8088,7 +8151,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8196,7 +8260,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8289,7 +8354,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8625,7 +8691,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8688,7 +8755,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9001,7 +9069,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9070,7 +9139,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9124,7 +9194,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9161,7 +9232,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9212,7 +9284,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9320,7 +9393,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9413,7 +9487,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9749,7 +9824,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9812,7 +9888,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10125,7 +10202,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10194,7 +10272,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10248,7 +10327,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10285,7 +10365,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.offerobject.html b/docs/dyn/walletobjects_v1.offerobject.html
index d072797d09f..a6fe6458f0e 100644
--- a/docs/dyn/walletobjects_v1.offerobject.html
+++ b/docs/dyn/walletobjects_v1.offerobject.html
@@ -183,7 +183,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -291,7 +292,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -384,7 +386,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -504,7 +507,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -612,7 +616,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -705,7 +710,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1041,7 +1047,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1104,7 +1111,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1417,7 +1425,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1486,7 +1495,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1540,7 +1550,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1577,7 +1588,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1622,7 +1634,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1663,7 +1676,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1963,7 +1977,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2042,7 +2057,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2150,7 +2166,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2243,7 +2260,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2363,7 +2381,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2471,7 +2490,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2564,7 +2584,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2900,7 +2921,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2963,7 +2985,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3276,7 +3299,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3345,7 +3369,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3399,7 +3424,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3436,7 +3462,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3481,7 +3508,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3522,7 +3550,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3822,7 +3851,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3889,7 +3919,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3997,7 +4028,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4090,7 +4122,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4210,7 +4243,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4318,7 +4352,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4411,7 +4446,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4747,7 +4783,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4810,7 +4847,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5123,7 +5161,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5192,7 +5231,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5246,7 +5286,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5283,7 +5324,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5328,7 +5370,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5369,7 +5412,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5669,7 +5713,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5735,7 +5780,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5843,7 +5889,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5936,7 +5983,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6056,7 +6104,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6164,7 +6213,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6257,7 +6307,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6593,7 +6644,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6656,7 +6708,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6969,7 +7022,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7038,7 +7092,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7092,7 +7147,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7129,7 +7185,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7174,7 +7231,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7215,7 +7273,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7515,7 +7574,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7597,7 +7657,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7705,7 +7766,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7798,7 +7860,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7918,7 +7981,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8026,7 +8090,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8119,7 +8184,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8455,7 +8521,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8518,7 +8585,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8831,7 +8899,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8900,7 +8969,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8954,7 +9024,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8991,7 +9062,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9036,7 +9108,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9077,7 +9150,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9377,7 +9451,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9447,7 +9522,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9555,7 +9631,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9648,7 +9725,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9768,7 +9846,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9876,7 +9955,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9969,7 +10049,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10305,7 +10386,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10368,7 +10450,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10681,7 +10764,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10750,7 +10834,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10804,7 +10889,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10841,7 +10927,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10886,7 +10973,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10927,7 +11015,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11227,7 +11316,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11293,7 +11383,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11401,7 +11492,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11494,7 +11586,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11614,7 +11707,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11722,7 +11816,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11815,7 +11910,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12151,7 +12247,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12214,7 +12311,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12527,7 +12625,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12596,7 +12695,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12650,7 +12750,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12687,7 +12788,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12732,7 +12834,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12773,7 +12876,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13073,7 +13177,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13141,7 +13246,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13249,7 +13355,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13342,7 +13449,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13462,7 +13570,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13570,7 +13679,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13663,7 +13773,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13999,7 +14110,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14062,7 +14174,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14375,7 +14488,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14444,7 +14558,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14498,7 +14613,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14535,7 +14651,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14580,7 +14697,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14621,7 +14739,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14921,7 +15040,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14987,7 +15107,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15095,7 +15216,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15188,7 +15310,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15308,7 +15431,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15416,7 +15540,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15509,7 +15634,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15845,7 +15971,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15908,7 +16035,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16221,7 +16349,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16290,7 +16419,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16344,7 +16474,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16381,7 +16512,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16426,7 +16558,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16467,7 +16600,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16767,7 +16901,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.transitclass.html b/docs/dyn/walletobjects_v1.transitclass.html
index 09a1f47d2dc..9c3029f8b08 100644
--- a/docs/dyn/walletobjects_v1.transitclass.html
+++ b/docs/dyn/walletobjects_v1.transitclass.html
@@ -188,7 +188,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -296,7 +297,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -389,7 +391,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -988,7 +991,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1051,7 +1055,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1182,7 +1187,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1370,7 +1376,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1424,7 +1431,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1461,7 +1469,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1498,7 +1507,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1566,7 +1576,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1674,7 +1685,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1767,7 +1779,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2366,7 +2379,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2429,7 +2443,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2560,7 +2575,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2748,7 +2764,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2802,7 +2819,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2839,7 +2857,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2876,7 +2895,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2932,7 +2952,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3040,7 +3061,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3133,7 +3155,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3732,7 +3755,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3795,7 +3819,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3926,7 +3951,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4114,7 +4140,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4168,7 +4195,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4205,7 +4233,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4242,7 +4271,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4297,7 +4327,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4405,7 +4436,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4498,7 +4530,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5097,7 +5130,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5160,7 +5194,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5291,7 +5326,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5479,7 +5515,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5533,7 +5570,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5570,7 +5608,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5607,7 +5646,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5678,7 +5718,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5786,7 +5827,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5879,7 +5921,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6478,7 +6521,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6541,7 +6585,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6672,7 +6717,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6860,7 +6906,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6914,7 +6961,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6951,7 +6999,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6988,7 +7037,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7047,7 +7097,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7155,7 +7206,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7248,7 +7300,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7847,7 +7900,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7910,7 +7964,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8041,7 +8096,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8229,7 +8285,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8283,7 +8340,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8320,7 +8378,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8357,7 +8416,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8412,7 +8472,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8520,7 +8581,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8613,7 +8675,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9212,7 +9275,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9275,7 +9339,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9406,7 +9471,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9594,7 +9660,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9648,7 +9715,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9685,7 +9753,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9722,7 +9791,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9779,7 +9849,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9887,7 +9958,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9980,7 +10052,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10579,7 +10652,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10642,7 +10716,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10773,7 +10848,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10961,7 +11037,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11015,7 +11092,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11052,7 +11130,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11089,7 +11168,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11144,7 +11224,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11252,7 +11333,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11345,7 +11427,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11944,7 +12027,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12007,7 +12091,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12138,7 +12223,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12326,7 +12412,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12380,7 +12467,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12417,7 +12505,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12454,7 +12543,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/docs/dyn/walletobjects_v1.transitobject.html b/docs/dyn/walletobjects_v1.transitobject.html
index cdc278b4ea3..7181a39c1a1 100644
--- a/docs/dyn/walletobjects_v1.transitobject.html
+++ b/docs/dyn/walletobjects_v1.transitobject.html
@@ -186,7 +186,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -294,7 +295,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -387,7 +389,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -511,7 +514,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -619,7 +623,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -712,7 +717,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1311,7 +1317,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1374,7 +1381,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1505,7 +1513,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1693,7 +1702,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1747,7 +1757,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1784,7 +1795,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1821,7 +1833,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1900,7 +1913,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -1942,7 +1956,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2656,7 +2671,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2738,7 +2754,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2846,7 +2863,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -2939,7 +2957,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3063,7 +3082,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3171,7 +3191,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3264,7 +3285,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3863,7 +3885,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -3926,7 +3949,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4057,7 +4081,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4245,7 +4270,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4299,7 +4325,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4336,7 +4363,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4373,7 +4401,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4452,7 +4481,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -4494,7 +4524,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5208,7 +5239,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5278,7 +5310,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5386,7 +5419,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5479,7 +5513,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5603,7 +5638,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5711,7 +5747,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -5804,7 +5841,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6403,7 +6441,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6466,7 +6505,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6597,7 +6637,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6785,7 +6826,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6839,7 +6881,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6876,7 +6919,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6913,7 +6957,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -6992,7 +7037,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7034,7 +7080,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7748,7 +7795,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7817,7 +7865,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -7925,7 +7974,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8018,7 +8068,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8142,7 +8193,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8250,7 +8302,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8343,7 +8396,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -8942,7 +8996,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9005,7 +9060,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9136,7 +9192,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9324,7 +9381,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9378,7 +9436,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9415,7 +9474,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9452,7 +9512,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9531,7 +9592,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -9573,7 +9635,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10287,7 +10350,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10372,7 +10436,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10480,7 +10545,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10573,7 +10639,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10697,7 +10764,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10805,7 +10873,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -10898,7 +10967,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11497,7 +11567,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11560,7 +11631,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11691,7 +11763,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11879,7 +11952,8 @@ 
Method Details

                 ],
               },
               "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-              "sourceUri": { # The URI for the image.
+              "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+              "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
                 "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
                 "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                   "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11933,7 +12007,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -11970,7 +12045,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12007,7 +12083,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12086,7 +12163,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12128,7 +12206,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12842,7 +12921,8 @@ 
Method Details

               ],
             },
             "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-            "sourceUri": { # The URI for the image.
+            "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+            "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
               "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
               "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
                 "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -12915,7 +12995,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13023,7 +13104,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13116,7 +13198,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13240,7 +13323,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13348,7 +13432,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -13441,7 +13526,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14040,7 +14126,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14103,7 +14190,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14234,7 +14322,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14422,7 +14511,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14476,7 +14566,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14513,7 +14604,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14550,7 +14642,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14629,7 +14722,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -14671,7 +14765,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15385,7 +15480,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15454,7 +15550,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15562,7 +15659,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15655,7 +15753,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15779,7 +15878,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15887,7 +15987,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -15980,7 +16081,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16579,7 +16681,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16642,7 +16745,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16773,7 +16877,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -16961,7 +17066,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17015,7 +17121,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17052,7 +17159,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17089,7 +17197,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17168,7 +17277,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17210,7 +17320,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17924,7 +18035,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -17995,7 +18107,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18103,7 +18216,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18196,7 +18310,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18320,7 +18435,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18428,7 +18544,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -18521,7 +18638,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19120,7 +19238,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19183,7 +19302,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19314,7 +19434,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19502,7 +19623,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19556,7 +19678,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19593,7 +19716,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19630,7 +19754,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19709,7 +19834,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -19751,7 +19877,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20465,7 +20592,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20534,7 +20662,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20642,7 +20771,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20735,7 +20865,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20859,7 +20990,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -20967,7 +21099,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -21060,7 +21193,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -21659,7 +21793,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -21722,7 +21857,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -21853,7 +21989,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -22041,7 +22178,8 @@ 
Method Details

             ],
           },
           "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-          "sourceUri": { # The URI for the image.
+          "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+          "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
             "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
             "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
               "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -22095,7 +22233,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -22132,7 +22271,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -22169,7 +22309,8 @@ 
Method Details

         ],
       },
       "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-      "sourceUri": { # The URI for the image.
+      "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+      "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
         "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
         "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
           "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -22248,7 +22389,8 @@ 
Method Details

       ],
     },
     "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-    "sourceUri": { # The URI for the image.
+    "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+    "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
       "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
       "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
         "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -22290,7 +22432,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
@@ -23004,7 +23147,8 @@ 
Method Details

           ],
         },
         "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string `"walletobjects#image"`.
-        "sourceUri": { # The URI for the image.
+        "privateImageId": "A String", # An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.
+        "sourceUri": { # A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected.
           "description": "A String", # Additional information about the image, which is unused and retained only for backward compatibility.
           "localizedDescription": { # Translated strings for the description, which are unused and retained only for backward compatibility.
             "defaultValue": { # Contains the string to be displayed if no appropriate translation is available.
diff --git a/googleapiclient/discovery_cache/documents/walletobjects.v1.json b/googleapiclient/discovery_cache/documents/walletobjects.v1.json
index bcb9991cebd..ef40a48ecae 100644
--- a/googleapiclient/discovery_cache/documents/walletobjects.v1.json
+++ b/googleapiclient/discovery_cache/documents/walletobjects.v1.json
@@ -2711,7 +2711,7 @@
 }
 }
 },
-"revision": "20250506",
+"revision": "20250804",
 "rootUrl": "https://walletobjects.googleapis.com/",
 "schemas": {
 "ActivationOptions": {
@@ -6206,9 +6206,13 @@ true
 "description": "Identifies what kind of resource this is. Value: the fixed string `\"walletobjects#image\"`.",
 "type": "string"
 },
+"privateImageId": {
+"description": "An ID for an already uploaded private image. Either this or source_uri should be set. Requests setting both or neither will be rejected. Please contact support to use private images.",
+"type": "string"
+},
 "sourceUri": {
 "$ref": "ImageUri",
-"description": "The URI for the image."
+"description": "A URI for the image. Either this or private_image_id should be set. Requests setting both or neither will be rejected."
 }
 },
 "type": "object"
@@ -9747,6 +9751,23 @@ true
 },
 "type": "object"
 },
+"UploadPrivateImageRequest": {
+"description": "Request to upload a private image to use in a pass.",
+"id": "UploadPrivateImageRequest",
+"properties": {},
+"type": "object"
+},
+"UploadPrivateImageResponse": {
+"description": "Response for uploading the private image.",
+"id": "UploadPrivateImageResponse",
+"properties": {
+"privateImageId": {
+"description": "Unique ID of the uploaded image to be referenced later in Image.private_image_id.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "Uri": {
 "id": "Uri",
 "properties": {

From 789d8422d9d71a9ec4c30e12f6b673f2909e1c3c Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 12 Aug 2025 07:10:01 +0000
Subject: [PATCH 32/32] chore(docs): Add new discovery artifacts and artifacts
 with minor updates

---
 ...roidmanagement_v1.enterprises.devices.html |   2 +-
 docs/dyn/apim_v1alpha.projects.locations.html |  26 +
 ...engine_v1.apps.authorizedCertificates.html |  10 +-
 .../appengine_v1.apps.authorizedDomains.html  |   2 +-
 .../dyn/appengine_v1.apps.domainMappings.html |  10 +-
 ...pengine_v1.apps.firewall.ingressRules.html |  34 +-
 docs/dyn/appengine_v1.apps.html               |  12 +-
 docs/dyn/appengine_v1.apps.services.html      |   8 +-
 .../appengine_v1.apps.services.versions.html  |  10 +-
 ...e_v1.apps.services.versions.instances.html |   8 +-
 ...s.applications.authorizedCertificates.html |  10 +-
 ...ations.applications.authorizedDomains.html |   2 +-
 ...locations.applications.domainMappings.html |   4 +-
 ...ne_v1.projects.locations.applications.html |   4 +-
 ...jects.locations.applications.services.html |   4 +-
 ...ations.applications.services.versions.html |   4 +-
 ...e_v1alpha.apps.authorizedCertificates.html |  10 +-
 ...engine_v1alpha.apps.authorizedDomains.html |   2 +-
 ...appengine_v1alpha.apps.domainMappings.html |  10 +-
 ...s.applications.authorizedCertificates.html |  10 +-
 ...ations.applications.authorizedDomains.html |   2 +-
 ...locations.applications.domainMappings.html |   4 +-
 ...ne_v1beta.apps.authorizedCertificates.html |  10 +-
 ...pengine_v1beta.apps.authorizedDomains.html |   2 +-
 .../appengine_v1beta.apps.domainMappings.html |  10 +-
 ...ine_v1beta.apps.firewall.ingressRules.html |  34 +-
 docs/dyn/appengine_v1beta.apps.html           |  12 +-
 docs/dyn/appengine_v1beta.apps.services.html  |   8 +-
 ...pengine_v1beta.apps.services.versions.html |  10 +-
 ...beta.apps.services.versions.instances.html |   8 +-
 ...s.applications.authorizedCertificates.html |  10 +-
 ...ations.applications.authorizedDomains.html |   2 +-
 ...locations.applications.domainMappings.html |   4 +-
 ...1beta.projects.locations.applications.html |   4 +-
 ...jects.locations.applications.services.html |   4 +-
 ...ations.applications.services.versions.html |   4 +-
 docs/dyn/chat_v1.spaces.html                  |  22 +-
 docs/dyn/chat_v1.spaces.messages.html         |  16 +-
 docs/dyn/chat_v1.spaces.spaceEvents.html      |  32 +-
 ...lex_v1.projects.locations.aspectTypes.html |   8 +-
 ...aplex_v1.projects.locations.dataScans.html |  40 +-
 ..._v1.projects.locations.dataScans.jobs.html |  14 +-
 ...rojects.locations.entryGroups.entries.html |  28 +-
 ...plex_v1.projects.locations.entryTypes.html |   8 +-
 docs/dyn/dataplex_v1.projects.locations.html  |  14 +-
 ...projects.locations.lakes.environments.html |   8 +-
 ...ojects.locations.lakes.zones.entities.html |  12 +-
 ...ex_v1.projects.locations.metadataJobs.html |  10 +-
 docs/dyn/digitalassetlinks_v1.assetlinks.html |   4 +-
 docs/dyn/drivelabels_v2.labels.html           | 984 +++++++++---------
 docs/dyn/drivelabels_v2.labels.locks.html     |  32 +-
 .../drivelabels_v2.labels.permissions.html    |  82 +-
 docs/dyn/drivelabels_v2.labels.revisions.html |  16 +-
 ...drivelabels_v2.labels.revisions.locks.html |  32 +-
 ...abels_v2.labels.revisions.permissions.html |  82 +-
 docs/dyn/drivelabels_v2.limits.html           |  60 +-
 docs/dyn/drivelabels_v2.users.html            |   6 +-
 docs/dyn/drivelabels_v2beta.labels.html       | 984 +++++++++---------
 docs/dyn/drivelabels_v2beta.labels.locks.html |  32 +-
 ...drivelabels_v2beta.labels.permissions.html |  82 +-
 .../drivelabels_v2beta.labels.revisions.html  |  16 +-
 ...elabels_v2beta.labels.revisions.locks.html |  32 +-
 ...s_v2beta.labels.revisions.permissions.html |  82 +-
 docs/dyn/drivelabels_v2beta.limits.html       |  60 +-
 docs/dyn/drivelabels_v2beta.users.html        |   6 +-
 ...entarc_v1.projects.locations.channels.html |   8 +-
 .../monitoring_v3.projects.alertPolicies.html |  36 +-
 ...y_v1.projects.locations.authzPolicies.html | 128 +--
 ...eta1.projects.locations.authzPolicies.html | 128 +--
 ...projects.locations.dnsThreatDetectors.html |  14 +-
 docs/dyn/solar_v1.buildingInsights.html       |   2 +-
 docs/dyn/solar_v1.dataLayers.html             |   2 +-
 docs/dyn/storagetransfer_v1.transferJobs.html | 108 +-
 docs/dyn/vision_v1.files.html                 |   4 +-
 docs/dyn/vision_v1.images.html                |   4 +-
 docs/dyn/vision_v1.projects.files.html        |   4 +-
 docs/dyn/vision_v1.projects.images.html       |   4 +-
 .../vision_v1.projects.locations.files.html   |   4 +-
 .../vision_v1.projects.locations.images.html  |   4 +-
 docs/dyn/vision_v1p1beta1.files.html          |   4 +-
 docs/dyn/vision_v1p1beta1.images.html         |   4 +-
 docs/dyn/vision_v1p1beta1.projects.files.html |   4 +-
 .../dyn/vision_v1p1beta1.projects.images.html |   4 +-
 ...on_v1p1beta1.projects.locations.files.html |   4 +-
 ...n_v1p1beta1.projects.locations.images.html |   4 +-
 docs/dyn/vision_v1p2beta1.files.html          |   4 +-
 docs/dyn/vision_v1p2beta1.images.html         |   4 +-
 docs/dyn/vision_v1p2beta1.projects.files.html |   4 +-
 .../dyn/vision_v1p2beta1.projects.images.html |   4 +-
 ...on_v1p2beta1.projects.locations.files.html |   4 +-
 ...n_v1p2beta1.projects.locations.images.html |   4 +-
 .../documents/adexchangebuyer2.v2beta1.json   |   8 +-
 .../documents/androidmanagement.v1.json       |   4 +-
 .../documents/apim.v1alpha.json               |  59 +-
 .../documents/appengine.v1.json               |  88 +-
 .../documents/appengine.v1alpha.json          |  40 +-
 .../documents/appengine.v1beta.json           |  88 +-
 .../discovery_cache/documents/chat.v1.json    |   4 +-
 .../documents/composer.v1.json                |   8 +-
 .../documents/composer.v1beta1.json           |   8 +-
 .../documents/dataplex.v1.json                |  50 +-
 .../documents/digitalassetlinks.v1.json       |   4 +-
 .../documents/driveactivity.v2.json           |  10 +-
 .../documents/drivelabels.v2.json             | 486 ++++-----
 .../documents/drivelabels.v2beta.json         | 486 ++++-----
 .../documents/eventarc.v1.json                |   4 +-
 .../discovery_cache/documents/gkehub.v1.json  |  28 +-
 .../documents/gkehub.v1alpha.json             |  54 +-
 .../documents/gkehub.v1beta.json              |  28 +-
 .../discovery_cache/documents/gkehub.v2.json  |  30 +-
 .../documents/gkehub.v2alpha.json             |  30 +-
 .../documents/gkehub.v2beta.json              |  30 +-
 .../documents/monitoring.v3.json              |   8 +-
 .../documents/networksecurity.v1.json         |  24 +-
 .../documents/networksecurity.v1beta1.json    |  28 +-
 .../discovery_cache/documents/solar.v1.json   |  10 +-
 .../documents/storagetransfer.v1.json         |  25 +-
 .../discovery_cache/documents/vision.v1.json  |   4 +-
 .../documents/vision.v1p1beta1.json           |   4 +-
 .../documents/vision.v1p2beta1.json           |   4 +-
 120 files changed, 2755 insertions(+), 2511 deletions(-)

diff --git a/docs/dyn/androidmanagement_v1.enterprises.devices.html b/docs/dyn/androidmanagement_v1.enterprises.devices.html
index 07f13356a62..331de6d9977 100644
--- a/docs/dyn/androidmanagement_v1.enterprises.devices.html
+++ b/docs/dyn/androidmanagement_v1.enterprises.devices.html
@@ -550,7 +550,7 @@ 
Method Details

 
 Args:
   parent: string, The name of the enterprise in the form enterprises/{enterpriseId}. (required)
-  pageSize: integer, The requested page size. The actual page size may be fixed to a min or max value.
+  pageSize: integer, The requested page size. If unspecified, at most 10 devices will be returned. The maximum value is 100; values above 100 will be coerced to 100. The limits can change over time.
   pageToken: string, A token identifying a page of results returned by the server.
   x__xgafv: string, V1 error format.
     Allowed values
diff --git a/docs/dyn/apim_v1alpha.projects.locations.html b/docs/dyn/apim_v1alpha.projects.locations.html
index 65d45531f31..ac5cdd9ff37 100644
--- a/docs/dyn/apim_v1alpha.projects.locations.html
+++ b/docs/dyn/apim_v1alpha.projects.locations.html
@@ -95,6 +95,9 @@ 
Instance Methods

 

   get(name, x__xgafv=None)

 
Gets information about a location.

+

+  getEntitlement(name, x__xgafv=None)

+
GetEntitlement returns the entitlement for the provided project.

 

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

 
Lists information about the supported locations for this service.

@@ -140,6 +143,29 @@ 
Method Details

 }

 

 
+

+    getEntitlement(name, x__xgafv=None)
+  
GetEntitlement returns the entitlement for the provided project.
+
+Args:
+  name: string, Required. The entitlement resource name Format: projects/{project}/locations/{location}/entitlement (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Entitlement stores data related to API Observation entitlement for a given project
+  "apiObservationEntitled": True or False, # Whether API Observation is entitled.
+  "billingProjectNumber": "A String", # Project number of associated billing project that has Apigee and Advanced API Security entitled.
+  "createTime": "A String", # Output only. The time of the entitlement creation.
+  "name": "A String", # Identifier. The entitlement resource name `projects/{project}/locations/{location}/entitlement`
+  "updateTime": "A String", # Output only. The time of the entitlement update.
+}

+

+
 

     list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)
   
Lists information about the supported locations for this service.
diff --git a/docs/dyn/appengine_v1.apps.authorizedCertificates.html b/docs/dyn/appengine_v1.apps.authorizedCertificates.html
index 26615c6c70a..402b8c97d6f 100644
--- a/docs/dyn/appengine_v1.apps.authorizedCertificates.html
+++ b/docs/dyn/appengine_v1.apps.authorizedCertificates.html
@@ -106,7 +106,7 @@ 
Method Details

   
Uploads the specified SSL certificate.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -168,7 +168,7 @@ 
Method Details

   
Deletes the specified SSL certificate.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -187,7 +187,7 @@ 
Method Details

   
Gets the specified SSL certificate.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `appsId`. (required)
   view: string, Controls the set of fields returned in the GET response.
     Allowed values
@@ -229,7 +229,7 @@ 
Method Details

   
Lists all SSL certificates the user is authorized to administer.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   view: string, Controls the set of fields returned in the LIST response.
@@ -291,7 +291,7 @@ 
Method Details

   
Updates the specified SSL certificate. To renew a certificate and maintain its existing domain mappings, update certificate_data with a new certificate. The new certificate must be applicable to the same domains as the original certificate. The certificate display_name may also be updated.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body.
     The object takes the form of:
diff --git a/docs/dyn/appengine_v1.apps.authorizedDomains.html b/docs/dyn/appengine_v1.apps.authorizedDomains.html
index a10bdf3d623..b90dc1d58b7 100644
--- a/docs/dyn/appengine_v1.apps.authorizedDomains.html
+++ b/docs/dyn/appengine_v1.apps.authorizedDomains.html
@@ -94,7 +94,7 @@ 
Method Details

   
Lists all domains the user is authorized to administer.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
diff --git a/docs/dyn/appengine_v1.apps.domainMappings.html b/docs/dyn/appengine_v1.apps.domainMappings.html
index 998a8c6cb68..04a7aad93f4 100644
--- a/docs/dyn/appengine_v1.apps.domainMappings.html
+++ b/docs/dyn/appengine_v1.apps.domainMappings.html
@@ -106,7 +106,7 @@ 
Method Details

   
Maps a domain to an application. A user must be authorized to administer a domain in order to map it to an application. For a list of available authorized domains, see AuthorizedDomains.ListAuthorizedDomains.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -166,7 +166,7 @@ 
Method Details

   
Deletes the specified domain mapping. A user must be authorized to administer the associated domain in order to delete a DomainMapping resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com. (required)
   domainMappingsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -202,7 +202,7 @@ 
Method Details

   
Gets the specified domain mapping.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
   domainMappingsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -235,7 +235,7 @@ 
Method Details

   
Lists the domain mappings on an application.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
@@ -288,7 +288,7 @@ 
Method Details

   
Updates the specified domain mapping. To map an SSL certificate to a domain mapping, update certificate_id to point to an AuthorizedCertificate resource. A user must be authorized to administer the associated domain in order to update a DomainMapping resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/domainMappings/example.com. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/domainMappings/example.com. (required)
   domainMappingsId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body.
     The object takes the form of:
diff --git a/docs/dyn/appengine_v1.apps.firewall.ingressRules.html b/docs/dyn/appengine_v1.apps.firewall.ingressRules.html
index 62832a12726..e0b21744c0f 100644
--- a/docs/dyn/appengine_v1.apps.firewall.ingressRules.html
+++ b/docs/dyn/appengine_v1.apps.firewall.ingressRules.html
@@ -110,10 +110,10 @@ 
Method Details

 
 { # Request message for Firewall.BatchUpdateIngressRules.
   "ingressRules": [ # A list of FirewallRules to replace the existing set.
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
       "action": "A String", # The action to take on matched requests.
       "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-      "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+      "priority": 42,
       "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
     },
   ],
@@ -129,10 +129,10 @@ 
Method Details

 
     { # Response message for Firewall.UpdateAllIngressRules.
   "ingressRules": [ # The full list of ingress FirewallRules for this application.
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
       "action": "A String", # The action to take on matched requests.
       "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-      "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+      "priority": 42,
       "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
     },
   ],
@@ -149,14 +149,14 @@ 
Method Details

   
Creates a firewall rule for the application.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Firewall collection in which to create a new rule. Example: apps/myapp/firewall/ingressRules. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Firewall collection in which to create a new rule. Example: apps/myapp/firewall/ingressRules. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+{ # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
   "action": "A String", # The action to take on matched requests.
   "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-  "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+  "priority": 42,
   "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
 }
 
@@ -168,10 +168,10 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
   "action": "A String", # The action to take on matched requests.
   "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-  "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+  "priority": 42,
   "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
 }

 

@@ -210,10 +210,10 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
   "action": "A String", # The action to take on matched requests.
   "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-  "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+  "priority": 42,
   "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
 }

 
@@ -237,10 +237,10 @@ 
Method Details

 
     { # Response message for Firewall.ListIngressRules.
   "ingressRules": [ # The ingress FirewallRules for this application.
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
       "action": "A String", # The action to take on matched requests.
       "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-      "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+      "priority": 42,
       "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
     },
   ],
@@ -272,10 +272,10 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+{ # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
   "action": "A String", # The action to take on matched requests.
   "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-  "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+  "priority": 42,
   "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
 }
 
@@ -288,10 +288,10 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
   "action": "A String", # The action to take on matched requests.
   "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-  "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+  "priority": 42,
   "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
 }
diff --git a/docs/dyn/appengine_v1.apps.html b/docs/dyn/appengine_v1.apps.html index c337bd1b0f4..a37ed90fca5 100644 --- a/docs/dyn/appengine_v1.apps.html +++ b/docs/dyn/appengine_v1.apps.html @@ -171,7 +171,7 @@

Method Details

}, "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp. "locationId": "A String", # Location from which this application runs. Application instances run out of the data centers in the specified location, which is also where all of the application's end user content is stored.Defaults to us-central.View the list of supported locations (https://cloud.google.com/appengine/docs/locations). - "name": "A String", # Output only. Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly + "name": "A String", "serviceAccount": "A String", # The service account associated with the application. This is the app-level default identity. If no identity provided during create version, Admin API will fallback to this one. "servingStatus": "A String", # Serving status of this application. "sslPolicy": "A String", # The SSL policy that will be applied to the application. If set to Modern it will restrict traffic with TLS < 1.2 and allow only Modern Ciphers suite @@ -211,7 +211,7 @@

Method Details

Gets information about an application.
 
 Args:
-  appsId: string, Part of `name`. Name of the Application resource to get. Example: apps/myapp. (required)
+  appsId: string, Part of `name`. Required. Name of the Application resource to get. Example: apps/myapp. (required)
   includeExtraData: string, Options to include extra data
     Allowed values
       INCLUDE_EXTRA_DATA_UNSPECIFIED - Unspecified: No extra data will be returned
@@ -255,7 +255,7 @@ 
Method Details

   },
   "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   "locationId": "A String", # Location from which this application runs. Application instances run out of the data centers in the specified location, which is also where all of the application's end user content is stored.Defaults to us-central.View the list of supported locations (https://cloud.google.com/appengine/docs/locations).
-  "name": "A String", # Output only. Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+  "name": "A String",
   "serviceAccount": "A String", # The service account associated with the application. This is the app-level default identity. If no identity provided during create version, Admin API will fallback to this one.
   "servingStatus": "A String", # Serving status of this application.
   "sslPolicy": "A String", # The SSL policy that will be applied to the application. If set to Modern it will restrict traffic with TLS < 1.2 and allow only Modern Ciphers suite
@@ -320,7 +320,7 @@ 
Method Details

   
Updates the specified Application resource. You can update the following fields: auth_domain - Google authentication domain for controlling user access to the application. default_cookie_expiration - Cookie expiration policy for the application. iap - Identity-Aware Proxy properties for the application.
 
 Args:
-  appsId: string, Part of `name`. Name of the Application resource to update. Example: apps/myapp. (required)
+  appsId: string, Part of `name`. Required. Name of the Application resource to update. Example: apps/myapp. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -354,7 +354,7 @@ 
Method Details

   },
   "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   "locationId": "A String", # Location from which this application runs. Application instances run out of the data centers in the specified location, which is also where all of the application's end user content is stored.Defaults to us-central.View the list of supported locations (https://cloud.google.com/appengine/docs/locations).
-  "name": "A String", # Output only. Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+  "name": "A String",
   "serviceAccount": "A String", # The service account associated with the application. This is the app-level default identity. If no identity provided during create version, Admin API will fallback to this one.
   "servingStatus": "A String", # Serving status of this application.
   "sslPolicy": "A String", # The SSL policy that will be applied to the application. If set to Modern it will restrict traffic with TLS < 1.2 and allow only Modern Ciphers suite
@@ -395,7 +395,7 @@ 
Method Details

   
Recreates the required App Engine features for the specified App Engine application, for example a Cloud Storage bucket or App Engine service account. Use this method if you receive an error message about a missing feature, for example, Error retrieving the App Engine service account. If you have deleted your App Engine service account, this will not be able to recreate it. Instead, you should attempt to use the IAM undelete API if possible at https://cloud.google.com/iam/reference/rest/v1/projects.serviceAccounts/undelete?apix_params=%7B"name"%3A"projects%2F-%2FserviceAccounts%2Funique_id"%2C"resource"%3A%7B%7D%7D . If the deletion was recent, the numeric ID can be found in the Cloud Console Activity Log.
 
 Args:
-  appsId: string, Part of `name`. Name of the application to repair. Example: apps/myapp (required)
+  appsId: string, Part of `name`. Required. Name of the application to repair. Example: apps/myapp (required)
   body: object, The request body.
     The object takes the form of:
 
diff --git a/docs/dyn/appengine_v1.apps.services.html b/docs/dyn/appengine_v1.apps.services.html
index 0bb7c7d5c39..153b2aa0f86 100644
--- a/docs/dyn/appengine_v1.apps.services.html
+++ b/docs/dyn/appengine_v1.apps.services.html
@@ -108,7 +108,7 @@ 
Method Details

   
Deletes the specified service and all enclosed versions.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -144,7 +144,7 @@ 
Method Details

   
Gets the current configuration of the specified service.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -180,7 +180,7 @@ 
Method Details

   
Lists all the services in the application.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
@@ -236,7 +236,7 @@ 
Method Details

   
Updates the configuration of the specified service.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body.
     The object takes the form of:
diff --git a/docs/dyn/appengine_v1.apps.services.versions.html b/docs/dyn/appengine_v1.apps.services.versions.html
index cc7205a20b4..3f6752831b4 100644
--- a/docs/dyn/appengine_v1.apps.services.versions.html
+++ b/docs/dyn/appengine_v1.apps.services.versions.html
@@ -111,7 +111,7 @@ 
Method Details

   
Deploys code and resource files to a new version.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent resource to create this version under. Example: apps/myapp/services/default. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent resource to create this version under. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `parent`. See documentation of `appsId`. (required)
   body: object, The request body.
     The object takes the form of:
@@ -366,7 +366,7 @@ 
Method Details

   
Deletes an existing Version resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
@@ -403,7 +403,7 @@ 
Method Details

   
Gets the specified Version resource. By default, only a BASIC_VIEW will be returned. Specify the FULL_VIEW parameter to get the full resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   view: string, Controls the set of fields returned in the Get response.
@@ -640,7 +640,7 @@ 
Method Details

   
Lists the versions of a service.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Service resource. Example: apps/myapp/services/default. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Service resource. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `parent`. See documentation of `appsId`. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
@@ -897,7 +897,7 @@ 
Method Details

   
Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses:Standard environment instance_class (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class)automatic scaling in the standard environment: automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.max_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automaticScaling.standard_scheduler_settings.max_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.min_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.target_cpu_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.target_throughput_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings)basic scaling or manual scaling in the standard environment: serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status) manual_scaling.instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#manualscaling)Flexible environment serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status)automatic scaling in the flexible environment: automatic_scaling.min_total_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.max_total_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.cool_down_period_sec (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.cpu_utilization.target_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling)manual scaling in the flexible environment: manual_scaling.instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#manualscaling)
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default/versions/1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default/versions/1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body.
diff --git a/docs/dyn/appengine_v1.apps.services.versions.instances.html b/docs/dyn/appengine_v1.apps.services.versions.instances.html
index 3dad44558c6..0116c9b5443 100644
--- a/docs/dyn/appengine_v1.apps.services.versions.instances.html
+++ b/docs/dyn/appengine_v1.apps.services.versions.instances.html
@@ -103,7 +103,7 @@ 
Method Details

   
Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started.Only applicable for instances in App Engine flexible environment.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
@@ -148,7 +148,7 @@ 
Method Details

   
Stops a running instance.The instance might be automatically recreated based on the scaling settings of the version. For more information, see "How Instances are Managed" (standard environment (https://cloud.google.com/appengine/docs/standard/python/how-instances-are-managed) | flexible environment (https://cloud.google.com/appengine/docs/flexible/python/how-instances-are-managed)).To ensure that instances are not re-created and avoid getting billed, you can stop all instances within the target version by changing the serving status of the version to STOPPED with the apps.services.versions.patch (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions/patch) method.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
@@ -186,7 +186,7 @@ 
Method Details

   
Gets instance information.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
@@ -224,7 +224,7 @@ 
Method Details

   
Lists the instances of a version.Tip: To aggregate details about instances over time, see the Stackdriver Monitoring API (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Version resource. Example: apps/myapp/services/default/versions/v1. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Version resource. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `parent`. See documentation of `appsId`. (required)
   versionsId: string, Part of `parent`. See documentation of `appsId`. (required)
   pageSize: integer, Maximum results to return per page.
diff --git a/docs/dyn/appengine_v1.projects.locations.applications.authorizedCertificates.html b/docs/dyn/appengine_v1.projects.locations.applications.authorizedCertificates.html
index 2923e2b5917..8e83c035cf4 100644
--- a/docs/dyn/appengine_v1.projects.locations.applications.authorizedCertificates.html
+++ b/docs/dyn/appengine_v1.projects.locations.applications.authorizedCertificates.html
@@ -106,7 +106,7 @@ 
Method Details

   
Uploads the specified SSL certificate.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   body: object, The request body.
@@ -170,7 +170,7 @@ 
Method Details

   
Deletes the specified SSL certificate.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `projectsId`. (required)
@@ -191,7 +191,7 @@ 
Method Details

   
Gets the specified SSL certificate.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `projectsId`. (required)
@@ -235,7 +235,7 @@ 
Method Details

   
Lists all SSL certificates the user is authorized to administer.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   pageSize: integer, Maximum results to return per page.
@@ -299,7 +299,7 @@ 
Method Details

   
Updates the specified SSL certificate. To renew a certificate and maintain its existing domain mappings, update certificate_data with a new certificate. The new certificate must be applicable to the same domains as the original certificate. The certificate display_name may also be updated.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `projectsId`. (required)
diff --git a/docs/dyn/appengine_v1.projects.locations.applications.authorizedDomains.html b/docs/dyn/appengine_v1.projects.locations.applications.authorizedDomains.html
index 830af05d945..0a899bda0af 100644
--- a/docs/dyn/appengine_v1.projects.locations.applications.authorizedDomains.html
+++ b/docs/dyn/appengine_v1.projects.locations.applications.authorizedDomains.html
@@ -94,7 +94,7 @@ 
Method Details

   
Lists all domains the user is authorized to administer.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   pageSize: integer, Maximum results to return per page.
diff --git a/docs/dyn/appengine_v1.projects.locations.applications.domainMappings.html b/docs/dyn/appengine_v1.projects.locations.applications.domainMappings.html
index 6a121ebd85f..5e1e67a87d3 100644
--- a/docs/dyn/appengine_v1.projects.locations.applications.domainMappings.html
+++ b/docs/dyn/appengine_v1.projects.locations.applications.domainMappings.html
@@ -94,7 +94,7 @@ 
Method Details

   
Maps a domain to an application. A user must be authorized to administer a domain in order to map it to an application. For a list of available authorized domains, see AuthorizedDomains.ListAuthorizedDomains.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   body: object, The request body.
@@ -156,7 +156,7 @@ 
Method Details

   
Gets the specified domain mapping.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   domainMappingsId: string, Part of `name`. See documentation of `projectsId`. (required)
diff --git a/docs/dyn/appengine_v1.projects.locations.applications.html b/docs/dyn/appengine_v1.projects.locations.applications.html
index e7dd6fbd1a8..ac79d327fc9 100644
--- a/docs/dyn/appengine_v1.projects.locations.applications.html
+++ b/docs/dyn/appengine_v1.projects.locations.applications.html
@@ -111,7 +111,7 @@ 
Method Details

   
Updates the specified Application resource. You can update the following fields: auth_domain - Google authentication domain for controlling user access to the application. default_cookie_expiration - Cookie expiration policy for the application. iap - Identity-Aware Proxy properties for the application.
 
 Args:
-  projectsId: string, Part of `name`. Name of the Application resource to update. Example: apps/myapp. (required)
+  projectsId: string, Part of `name`. Required. Name of the Application resource to update. Example: apps/myapp. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   body: object, The request body.
@@ -147,7 +147,7 @@ 
Method Details

   },
   "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   "locationId": "A String", # Location from which this application runs. Application instances run out of the data centers in the specified location, which is also where all of the application's end user content is stored.Defaults to us-central.View the list of supported locations (https://cloud.google.com/appengine/docs/locations).
-  "name": "A String", # Output only. Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+  "name": "A String",
   "serviceAccount": "A String", # The service account associated with the application. This is the app-level default identity. If no identity provided during create version, Admin API will fallback to this one.
   "servingStatus": "A String", # Serving status of this application.
   "sslPolicy": "A String", # The SSL policy that will be applied to the application. If set to Modern it will restrict traffic with TLS < 1.2 and allow only Modern Ciphers suite
diff --git a/docs/dyn/appengine_v1.projects.locations.applications.services.html b/docs/dyn/appengine_v1.projects.locations.applications.services.html
index 150da95c795..afaa112f155 100644
--- a/docs/dyn/appengine_v1.projects.locations.applications.services.html
+++ b/docs/dyn/appengine_v1.projects.locations.applications.services.html
@@ -99,7 +99,7 @@ 
Method Details

   
Deletes the specified service and all enclosed versions.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   servicesId: string, Part of `name`. See documentation of `projectsId`. (required)
@@ -137,7 +137,7 @@ 
Method Details

   
Updates the configuration of the specified service.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   servicesId: string, Part of `name`. See documentation of `projectsId`. (required)
diff --git a/docs/dyn/appengine_v1.projects.locations.applications.services.versions.html b/docs/dyn/appengine_v1.projects.locations.applications.services.versions.html
index 0b24386f056..cd42552ace8 100644
--- a/docs/dyn/appengine_v1.projects.locations.applications.services.versions.html
+++ b/docs/dyn/appengine_v1.projects.locations.applications.services.versions.html
@@ -94,7 +94,7 @@ 
Method Details

   
Deletes an existing Version resource.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   servicesId: string, Part of `name`. See documentation of `projectsId`. (required)
@@ -133,7 +133,7 @@ 
Method Details

   
Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses:Standard environment instance_class (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class)automatic scaling in the standard environment: automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.max_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automaticScaling.standard_scheduler_settings.max_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.min_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.target_cpu_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.target_throughput_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings)basic scaling or manual scaling in the standard environment: serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status) manual_scaling.instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#manualscaling)Flexible environment serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status)automatic scaling in the flexible environment: automatic_scaling.min_total_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.max_total_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.cool_down_period_sec (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.cpu_utilization.target_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling)manual scaling in the flexible environment: manual_scaling.instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#manualscaling)
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default/versions/1. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default/versions/1. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   servicesId: string, Part of `name`. See documentation of `projectsId`. (required)
diff --git a/docs/dyn/appengine_v1alpha.apps.authorizedCertificates.html b/docs/dyn/appengine_v1alpha.apps.authorizedCertificates.html
index 47da06adf40..d88a06dd776 100644
--- a/docs/dyn/appengine_v1alpha.apps.authorizedCertificates.html
+++ b/docs/dyn/appengine_v1alpha.apps.authorizedCertificates.html
@@ -106,7 +106,7 @@ 
Method Details

   
Uploads the specified SSL certificate.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -168,7 +168,7 @@ 
Method Details

   
Deletes the specified SSL certificate.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -187,7 +187,7 @@ 
Method Details

   
Gets the specified SSL certificate.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `appsId`. (required)
   view: string, Controls the set of fields returned in the GET response.
     Allowed values
@@ -229,7 +229,7 @@ 
Method Details

   
Lists all SSL certificates the user is authorized to administer.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   view: string, Controls the set of fields returned in the LIST response.
@@ -291,7 +291,7 @@ 
Method Details

   
Updates the specified SSL certificate. To renew a certificate and maintain its existing domain mappings, update certificate_data with a new certificate. The new certificate must be applicable to the same domains as the original certificate. The certificate display_name may also be updated.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body.
     The object takes the form of:
diff --git a/docs/dyn/appengine_v1alpha.apps.authorizedDomains.html b/docs/dyn/appengine_v1alpha.apps.authorizedDomains.html
index fd3374c4c11..7c4ea561d7e 100644
--- a/docs/dyn/appengine_v1alpha.apps.authorizedDomains.html
+++ b/docs/dyn/appengine_v1alpha.apps.authorizedDomains.html
@@ -94,7 +94,7 @@ 
Method Details

   
Lists all domains the user is authorized to administer.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
diff --git a/docs/dyn/appengine_v1alpha.apps.domainMappings.html b/docs/dyn/appengine_v1alpha.apps.domainMappings.html
index 5d8400e1227..8396e092dbb 100644
--- a/docs/dyn/appengine_v1alpha.apps.domainMappings.html
+++ b/docs/dyn/appengine_v1alpha.apps.domainMappings.html
@@ -106,7 +106,7 @@ 
Method Details

   
Maps a domain to an application. A user must be authorized to administer a domain in order to map it to an application. For a list of available authorized domains, see AuthorizedDomains.ListAuthorizedDomains.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -166,7 +166,7 @@ 
Method Details

   
Deletes the specified domain mapping. A user must be authorized to administer the associated domain in order to delete a DomainMapping resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com. (required)
   domainMappingsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -202,7 +202,7 @@ 
Method Details

   
Gets the specified domain mapping.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
   domainMappingsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -234,7 +234,7 @@ 
Method Details

   
Lists the domain mappings on an application.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
@@ -286,7 +286,7 @@ 
Method Details

   
Updates the specified domain mapping. To map an SSL certificate to a domain mapping, update certificate_id to point to an AuthorizedCertificate resource. A user must be authorized to administer the associated domain in order to update a DomainMapping resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/domainMappings/example.com. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/domainMappings/example.com. (required)
   domainMappingsId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body.
     The object takes the form of:
diff --git a/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedCertificates.html b/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedCertificates.html
index 9b1e0c44b82..6bd4883a0f7 100644
--- a/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedCertificates.html
+++ b/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedCertificates.html
@@ -106,7 +106,7 @@ 
Method Details

   
Uploads the specified SSL certificate.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   body: object, The request body.
@@ -170,7 +170,7 @@ 
Method Details

   
Deletes the specified SSL certificate.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `projectsId`. (required)
@@ -191,7 +191,7 @@ 
Method Details

   
Gets the specified SSL certificate.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `projectsId`. (required)
@@ -235,7 +235,7 @@ 
Method Details

   
Lists all SSL certificates the user is authorized to administer.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   pageSize: integer, Maximum results to return per page.
@@ -299,7 +299,7 @@ 
Method Details

   
Updates the specified SSL certificate. To renew a certificate and maintain its existing domain mappings, update certificate_data with a new certificate. The new certificate must be applicable to the same domains as the original certificate. The certificate display_name may also be updated.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `projectsId`. (required)
diff --git a/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedDomains.html b/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedDomains.html
index a8457976739..46fc10ec360 100644
--- a/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedDomains.html
+++ b/docs/dyn/appengine_v1alpha.projects.locations.applications.authorizedDomains.html
@@ -94,7 +94,7 @@ 
Method Details

   
Lists all domains the user is authorized to administer.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   pageSize: integer, Maximum results to return per page.
diff --git a/docs/dyn/appengine_v1alpha.projects.locations.applications.domainMappings.html b/docs/dyn/appengine_v1alpha.projects.locations.applications.domainMappings.html
index f015a8d7595..8fe28fb36f9 100644
--- a/docs/dyn/appengine_v1alpha.projects.locations.applications.domainMappings.html
+++ b/docs/dyn/appengine_v1alpha.projects.locations.applications.domainMappings.html
@@ -94,7 +94,7 @@ 
Method Details

   
Maps a domain to an application. A user must be authorized to administer a domain in order to map it to an application. For a list of available authorized domains, see AuthorizedDomains.ListAuthorizedDomains.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   body: object, The request body.
@@ -156,7 +156,7 @@ 
Method Details

   
Gets the specified domain mapping.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   domainMappingsId: string, Part of `name`. See documentation of `projectsId`. (required)
diff --git a/docs/dyn/appengine_v1beta.apps.authorizedCertificates.html b/docs/dyn/appengine_v1beta.apps.authorizedCertificates.html
index 69dc81303c6..60c8988ac08 100644
--- a/docs/dyn/appengine_v1beta.apps.authorizedCertificates.html
+++ b/docs/dyn/appengine_v1beta.apps.authorizedCertificates.html
@@ -106,7 +106,7 @@ 
Method Details

   
Uploads the specified SSL certificate.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -168,7 +168,7 @@ 
Method Details

   
Deletes the specified SSL certificate.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -187,7 +187,7 @@ 
Method Details

   
Gets the specified SSL certificate.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `appsId`. (required)
   view: string, Controls the set of fields returned in the GET response.
     Allowed values
@@ -229,7 +229,7 @@ 
Method Details

   
Lists all SSL certificates the user is authorized to administer.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   view: string, Controls the set of fields returned in the LIST response.
@@ -291,7 +291,7 @@ 
Method Details

   
Updates the specified SSL certificate. To renew a certificate and maintain its existing domain mappings, update certificate_data with a new certificate. The new certificate must be applicable to the same domains as the original certificate. The certificate display_name may also be updated.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body.
     The object takes the form of:
diff --git a/docs/dyn/appengine_v1beta.apps.authorizedDomains.html b/docs/dyn/appengine_v1beta.apps.authorizedDomains.html
index a09e1932a6f..5dc467e73ae 100644
--- a/docs/dyn/appengine_v1beta.apps.authorizedDomains.html
+++ b/docs/dyn/appengine_v1beta.apps.authorizedDomains.html
@@ -94,7 +94,7 @@ 
Method Details

   
Lists all domains the user is authorized to administer.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
diff --git a/docs/dyn/appengine_v1beta.apps.domainMappings.html b/docs/dyn/appengine_v1beta.apps.domainMappings.html
index be5bf295e3e..d4f90b3eec7 100644
--- a/docs/dyn/appengine_v1beta.apps.domainMappings.html
+++ b/docs/dyn/appengine_v1beta.apps.domainMappings.html
@@ -106,7 +106,7 @@ 
Method Details

   
Maps a domain to an application. A user must be authorized to administer a domain in order to map it to an application. For a list of available authorized domains, see AuthorizedDomains.ListAuthorizedDomains.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -166,7 +166,7 @@ 
Method Details

   
Deletes the specified domain mapping. A user must be authorized to administer the associated domain in order to delete a DomainMapping resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com. (required)
   domainMappingsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -202,7 +202,7 @@ 
Method Details

   
Gets the specified domain mapping.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
   domainMappingsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -235,7 +235,7 @@ 
Method Details

   
Lists the domain mappings on an application.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
@@ -288,7 +288,7 @@ 
Method Details

   
Updates the specified domain mapping. To map an SSL certificate to a domain mapping, update certificate_id to point to an AuthorizedCertificate resource. A user must be authorized to administer the associated domain in order to update a DomainMapping resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/domainMappings/example.com. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/domainMappings/example.com. (required)
   domainMappingsId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body.
     The object takes the form of:
diff --git a/docs/dyn/appengine_v1beta.apps.firewall.ingressRules.html b/docs/dyn/appengine_v1beta.apps.firewall.ingressRules.html
index 1cbf06906e1..8030a6032d7 100644
--- a/docs/dyn/appengine_v1beta.apps.firewall.ingressRules.html
+++ b/docs/dyn/appengine_v1beta.apps.firewall.ingressRules.html
@@ -110,10 +110,10 @@ 
Method Details

 
 { # Request message for Firewall.BatchUpdateIngressRules.
   "ingressRules": [ # A list of FirewallRules to replace the existing set.
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
       "action": "A String", # The action to take on matched requests.
       "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-      "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+      "priority": 42,
       "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
     },
   ],
@@ -129,10 +129,10 @@ 
Method Details

 
     { # Response message for Firewall.UpdateAllIngressRules.
   "ingressRules": [ # The full list of ingress FirewallRules for this application.
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
       "action": "A String", # The action to take on matched requests.
       "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-      "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+      "priority": 42,
       "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
     },
   ],
@@ -149,14 +149,14 @@ 
Method Details

   
Creates a firewall rule for the application.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Firewall collection in which to create a new rule. Example: apps/myapp/firewall/ingressRules. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Firewall collection in which to create a new rule. Example: apps/myapp/firewall/ingressRules. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+{ # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
   "action": "A String", # The action to take on matched requests.
   "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-  "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+  "priority": 42,
   "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
 }
 
@@ -168,10 +168,10 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
   "action": "A String", # The action to take on matched requests.
   "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-  "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+  "priority": 42,
   "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
 }

 
@@ -210,10 +210,10 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
   "action": "A String", # The action to take on matched requests.
   "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-  "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+  "priority": 42,
   "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
 }

 
@@ -237,10 +237,10 @@ 
Method Details

 
     { # Response message for Firewall.ListIngressRules.
   "ingressRules": [ # The ingress FirewallRules for this application.
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
       "action": "A String", # The action to take on matched requests.
       "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-      "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+      "priority": 42,
       "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
     },
   ],
@@ -272,10 +272,10 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+{ # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
   "action": "A String", # The action to take on matched requests.
   "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-  "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+  "priority": 42,
   "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
 }
 
@@ -288,10 +288,10 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.
+    { # A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
   "action": "A String", # The action to take on matched requests.
   "description": "A String", # An optional string description of this rule. This field has a maximum length of 400 characters.
-  "priority": 42, # A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
+  "priority": 42,
   "sourceRange": "A String", # IP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.
 }

 
diff --git a/docs/dyn/appengine_v1beta.apps.html b/docs/dyn/appengine_v1beta.apps.html
index b66908590d2..50d41ef1fa7 100644
--- a/docs/dyn/appengine_v1beta.apps.html
+++ b/docs/dyn/appengine_v1beta.apps.html
@@ -171,7 +171,7 @@ 
Method Details

   },
   "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   "locationId": "A String", # Location from which this application runs. Application instances run out of the data centers in the specified location, which is also where all of the application's end user content is stored.Defaults to us-central.View the list of supported locations (https://cloud.google.com/appengine/docs/locations).
-  "name": "A String", # Output only. Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+  "name": "A String",
   "serviceAccount": "A String", # The service account associated with the application. This is the app-level default identity. If no identity provided during create version, Admin API will fallback to this one.
   "servingStatus": "A String", # Serving status of this application.
   "sslPolicy": "A String", # The SSL policy that will be applied to the application. If set to Modern it will restrict traffic with TLS < 1.2 and allow only Modern Ciphers suite
@@ -211,7 +211,7 @@ 
Method Details

   
Gets information about an application.
 
 Args:
-  appsId: string, Part of `name`. Name of the Application resource to get. Example: apps/myapp. (required)
+  appsId: string, Part of `name`. Required. Name of the Application resource to get. Example: apps/myapp. (required)
   includeExtraData: string, Optional. Options to include extra data
     Allowed values
       INCLUDE_EXTRA_DATA_UNSPECIFIED - Unspecified: No extra data will be returned
@@ -255,7 +255,7 @@ 
Method Details

   },
   "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   "locationId": "A String", # Location from which this application runs. Application instances run out of the data centers in the specified location, which is also where all of the application's end user content is stored.Defaults to us-central.View the list of supported locations (https://cloud.google.com/appengine/docs/locations).
-  "name": "A String", # Output only. Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+  "name": "A String",
   "serviceAccount": "A String", # The service account associated with the application. This is the app-level default identity. If no identity provided during create version, Admin API will fallback to this one.
   "servingStatus": "A String", # Serving status of this application.
   "sslPolicy": "A String", # The SSL policy that will be applied to the application. If set to Modern it will restrict traffic with TLS < 1.2 and allow only Modern Ciphers suite
@@ -320,7 +320,7 @@ 
Method Details

   
Updates the specified Application resource. You can update the following fields: auth_domain - Google authentication domain for controlling user access to the application. default_cookie_expiration - Cookie expiration policy for the application. iap - Identity-Aware Proxy properties for the application.
 
 Args:
-  appsId: string, Part of `name`. Name of the Application resource to update. Example: apps/myapp. (required)
+  appsId: string, Part of `name`. Required. Name of the Application resource to update. Example: apps/myapp. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -354,7 +354,7 @@ 
Method Details

   },
   "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   "locationId": "A String", # Location from which this application runs. Application instances run out of the data centers in the specified location, which is also where all of the application's end user content is stored.Defaults to us-central.View the list of supported locations (https://cloud.google.com/appengine/docs/locations).
-  "name": "A String", # Output only. Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+  "name": "A String",
   "serviceAccount": "A String", # The service account associated with the application. This is the app-level default identity. If no identity provided during create version, Admin API will fallback to this one.
   "servingStatus": "A String", # Serving status of this application.
   "sslPolicy": "A String", # The SSL policy that will be applied to the application. If set to Modern it will restrict traffic with TLS < 1.2 and allow only Modern Ciphers suite
@@ -395,7 +395,7 @@ 
Method Details

   
Recreates the required App Engine features for the specified App Engine application, for example a Cloud Storage bucket or App Engine service account. Use this method if you receive an error message about a missing feature, for example, Error retrieving the App Engine service account. If you have deleted your App Engine service account, this will not be able to recreate it. Instead, you should attempt to use the IAM undelete API if possible at https://cloud.google.com/iam/reference/rest/v1/projects.serviceAccounts/undelete?apix_params=%7B"name"%3A"projects%2F-%2FserviceAccounts%2Funique_id"%2C"resource"%3A%7B%7D%7D . If the deletion was recent, the numeric ID can be found in the Cloud Console Activity Log.
 
 Args:
-  appsId: string, Part of `name`. Name of the application to repair. Example: apps/myapp (required)
+  appsId: string, Part of `name`. Required. Name of the application to repair. Example: apps/myapp (required)
   body: object, The request body.
     The object takes the form of:
 
diff --git a/docs/dyn/appengine_v1beta.apps.services.html b/docs/dyn/appengine_v1beta.apps.services.html
index 97ddc0d7179..c97afb2e382 100644
--- a/docs/dyn/appengine_v1beta.apps.services.html
+++ b/docs/dyn/appengine_v1beta.apps.services.html
@@ -108,7 +108,7 @@ 
Method Details

   
Deletes the specified service and all enclosed versions.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
@@ -144,7 +144,7 @@ 
Method Details

   
Gets the current configuration of the specified service.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   includeExtraData: string, Optional. Options to include extra data
     Allowed values
@@ -185,7 +185,7 @@ 
Method Details

   
Lists all the services in the application.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
   x__xgafv: string, V1 error format.
@@ -241,7 +241,7 @@ 
Method Details

   
Updates the configuration of the specified service.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body.
     The object takes the form of:
diff --git a/docs/dyn/appengine_v1beta.apps.services.versions.html b/docs/dyn/appengine_v1beta.apps.services.versions.html
index 89908060e86..468ee079ffe 100644
--- a/docs/dyn/appengine_v1beta.apps.services.versions.html
+++ b/docs/dyn/appengine_v1beta.apps.services.versions.html
@@ -111,7 +111,7 @@ 
Method Details

   
Deploys code and resource files to a new version.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent resource to create this version under. Example: apps/myapp/services/default. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent resource to create this version under. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `parent`. See documentation of `appsId`. (required)
   body: object, The request body.
     The object takes the form of:
@@ -378,7 +378,7 @@ 
Method Details

   
Deletes an existing Version resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   x__xgafv: string, V1 error format.
@@ -415,7 +415,7 @@ 
Method Details

   
Gets the specified Version resource. By default, only a BASIC_VIEW will be returned. Specify the FULL_VIEW parameter to get the full resource.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   includeExtraData: string, Optional. Options to include extra data
@@ -669,7 +669,7 @@ 
Method Details

   
Lists the versions of a service.
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Service resource. Example: apps/myapp/services/default. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Service resource. Example: apps/myapp/services/default. (required)
   servicesId: string, Part of `parent`. See documentation of `appsId`. (required)
   pageSize: integer, Maximum results to return per page.
   pageToken: string, Continuation token for fetching the next page of results.
@@ -938,7 +938,7 @@ 
Method Details

   
Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses:Standard environment instance_class (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.instance_class)automatic scaling in the standard environment: automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.max_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) automaticScaling.standard_scheduler_settings.max_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.min_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.target_cpu_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.target_throughput_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings)basic scaling or manual scaling in the standard environment: serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.serving_status) manual_scaling.instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#manualscaling)Flexible environment serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.serving_status)automatic scaling in the flexible environment: automatic_scaling.min_total_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.max_total_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.cool_down_period_sec (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.cpu_utilization.target_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling)manual scaling in the flexible environment: manual_scaling.instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#manualscaling)
 
 Args:
-  appsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default/versions/1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default/versions/1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   body: object, The request body.
diff --git a/docs/dyn/appengine_v1beta.apps.services.versions.instances.html b/docs/dyn/appengine_v1beta.apps.services.versions.instances.html
index 496d6dabb98..62ac17e3432 100644
--- a/docs/dyn/appengine_v1beta.apps.services.versions.instances.html
+++ b/docs/dyn/appengine_v1beta.apps.services.versions.instances.html
@@ -103,7 +103,7 @@ 
Method Details

   
Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started.Only applicable for instances in App Engine flexible environment.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
@@ -148,7 +148,7 @@ 
Method Details

   
Stops a running instance.The instance might be automatically recreated based on the scaling settings of the version. For more information, see "How Instances are Managed" (standard environment (https://cloud.google.com/appengine/docs/standard/python/how-instances-are-managed) | flexible environment (https://cloud.google.com/appengine/docs/flexible/python/how-instances-are-managed)).To ensure that instances are not re-created and avoid getting billed, you can stop all instances within the target version by changing the serving status of the version to STOPPED with the apps.services.versions.patch (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions/patch) method.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
@@ -186,7 +186,7 @@ 
Method Details

   
Gets instance information.
 
 Args:
-  appsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
+  appsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. (required)
   servicesId: string, Part of `name`. See documentation of `appsId`. (required)
   versionsId: string, Part of `name`. See documentation of `appsId`. (required)
   instancesId: string, Part of `name`. See documentation of `appsId`. (required)
@@ -224,7 +224,7 @@ 
Method Details

   
Lists the instances of a version.Tip: To aggregate details about instances over time, see the Stackdriver Monitoring API (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).
 
 Args:
-  appsId: string, Part of `parent`. Name of the parent Version resource. Example: apps/myapp/services/default/versions/v1. (required)
+  appsId: string, Part of `parent`. Required. Name of the parent Version resource. Example: apps/myapp/services/default/versions/v1. (required)
   servicesId: string, Part of `parent`. See documentation of `appsId`. (required)
   versionsId: string, Part of `parent`. See documentation of `appsId`. (required)
   pageSize: integer, Maximum results to return per page.
diff --git a/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedCertificates.html b/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedCertificates.html
index 58f0236243f..27cfda57f6a 100644
--- a/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedCertificates.html
+++ b/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedCertificates.html
@@ -106,7 +106,7 @@ 
Method Details

   
Uploads the specified SSL certificate.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   body: object, The request body.
@@ -170,7 +170,7 @@ 
Method Details

   
Deletes the specified SSL certificate.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `projectsId`. (required)
@@ -191,7 +191,7 @@ 
Method Details

   
Gets the specified SSL certificate.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `projectsId`. (required)
@@ -235,7 +235,7 @@ 
Method Details

   
Lists all SSL certificates the user is authorized to administer.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   pageSize: integer, Maximum results to return per page.
@@ -299,7 +299,7 @@ 
Method Details

   
Updates the specified SSL certificate. To renew a certificate and maintain its existing domain mappings, update certificate_data with a new certificate. The new certificate must be applicable to the same domains as the original certificate. The certificate display_name may also be updated.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   authorizedCertificatesId: string, Part of `name`. See documentation of `projectsId`. (required)
diff --git a/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedDomains.html b/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedDomains.html
index 9e1b085c06b..4bf78997188 100644
--- a/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedDomains.html
+++ b/docs/dyn/appengine_v1beta.projects.locations.applications.authorizedDomains.html
@@ -94,7 +94,7 @@ 
Method Details

   
Lists all domains the user is authorized to administer.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   pageSize: integer, Maximum results to return per page.
diff --git a/docs/dyn/appengine_v1beta.projects.locations.applications.domainMappings.html b/docs/dyn/appengine_v1beta.projects.locations.applications.domainMappings.html
index e41fccf1118..a8047d4a0e4 100644
--- a/docs/dyn/appengine_v1beta.projects.locations.applications.domainMappings.html
+++ b/docs/dyn/appengine_v1beta.projects.locations.applications.domainMappings.html
@@ -94,7 +94,7 @@ 
Method Details

   
Maps a domain to an application. A user must be authorized to administer a domain in order to map it to an application. For a list of available authorized domains, see AuthorizedDomains.ListAuthorizedDomains.
 
 Args:
-  projectsId: string, Part of `parent`. Name of the parent Application resource. Example: apps/myapp. (required)
+  projectsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
   locationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `parent`. See documentation of `projectsId`. (required)
   body: object, The request body.
@@ -156,7 +156,7 @@ 
Method Details

   
Gets the specified domain mapping.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   domainMappingsId: string, Part of `name`. See documentation of `projectsId`. (required)
diff --git a/docs/dyn/appengine_v1beta.projects.locations.applications.html b/docs/dyn/appengine_v1beta.projects.locations.applications.html
index 9c31890d9a1..44bc7e96521 100644
--- a/docs/dyn/appengine_v1beta.projects.locations.applications.html
+++ b/docs/dyn/appengine_v1beta.projects.locations.applications.html
@@ -111,7 +111,7 @@ 
Method Details

   
Updates the specified Application resource. You can update the following fields: auth_domain - Google authentication domain for controlling user access to the application. default_cookie_expiration - Cookie expiration policy for the application. iap - Identity-Aware Proxy properties for the application.
 
 Args:
-  projectsId: string, Part of `name`. Name of the Application resource to update. Example: apps/myapp. (required)
+  projectsId: string, Part of `name`. Required. Name of the Application resource to update. Example: apps/myapp. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   body: object, The request body.
@@ -147,7 +147,7 @@ 
Method Details

   },
   "id": "A String", # Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: myapp.
   "locationId": "A String", # Location from which this application runs. Application instances run out of the data centers in the specified location, which is also where all of the application's end user content is stored.Defaults to us-central.View the list of supported locations (https://cloud.google.com/appengine/docs/locations).
-  "name": "A String", # Output only. Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly
+  "name": "A String",
   "serviceAccount": "A String", # The service account associated with the application. This is the app-level default identity. If no identity provided during create version, Admin API will fallback to this one.
   "servingStatus": "A String", # Serving status of this application.
   "sslPolicy": "A String", # The SSL policy that will be applied to the application. If set to Modern it will restrict traffic with TLS < 1.2 and allow only Modern Ciphers suite
diff --git a/docs/dyn/appengine_v1beta.projects.locations.applications.services.html b/docs/dyn/appengine_v1beta.projects.locations.applications.services.html
index 287475baa0b..9279a3a67a0 100644
--- a/docs/dyn/appengine_v1beta.projects.locations.applications.services.html
+++ b/docs/dyn/appengine_v1beta.projects.locations.applications.services.html
@@ -99,7 +99,7 @@ 
Method Details

   
Deletes the specified service and all enclosed versions.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   servicesId: string, Part of `name`. See documentation of `projectsId`. (required)
@@ -137,7 +137,7 @@ 
Method Details

   
Updates the configuration of the specified service.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   servicesId: string, Part of `name`. See documentation of `projectsId`. (required)
diff --git a/docs/dyn/appengine_v1beta.projects.locations.applications.services.versions.html b/docs/dyn/appengine_v1beta.projects.locations.applications.services.versions.html
index 8ee12c64b6f..43347ea2ea7 100644
--- a/docs/dyn/appengine_v1beta.projects.locations.applications.services.versions.html
+++ b/docs/dyn/appengine_v1beta.projects.locations.applications.services.versions.html
@@ -94,7 +94,7 @@ 
Method Details

   
Deletes an existing Version resource.
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   servicesId: string, Part of `name`. See documentation of `projectsId`. (required)
@@ -133,7 +133,7 @@ 
Method Details

   
Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses:Standard environment instance_class (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.instance_class)automatic scaling in the standard environment: automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.max_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) automaticScaling.standard_scheduler_settings.max_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.min_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.target_cpu_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.target_throughput_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings)basic scaling or manual scaling in the standard environment: serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.serving_status) manual_scaling.instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#manualscaling)Flexible environment serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.serving_status)automatic scaling in the flexible environment: automatic_scaling.min_total_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.max_total_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.cool_down_period_sec (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.cpu_utilization.target_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling)manual scaling in the flexible environment: manual_scaling.instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#manualscaling)
 
 Args:
-  projectsId: string, Part of `name`. Name of the resource to update. Example: apps/myapp/services/default/versions/1. (required)
+  projectsId: string, Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default/versions/1. (required)
   locationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   applicationsId: string, Part of `name`. See documentation of `projectsId`. (required)
   servicesId: string, Part of `name`. See documentation of `projectsId`. (required)
diff --git a/docs/dyn/chat_v1.spaces.html b/docs/dyn/chat_v1.spaces.html
index a275e236d95..109c5f35e8c 100644
--- a/docs/dyn/chat_v1.spaces.html
+++ b/docs/dyn/chat_v1.spaces.html
@@ -159,7 +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.
+    "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.
     "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).
@@ -235,7 +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.
+  "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.
   "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).
@@ -310,7 +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.
+  "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.
   "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).
@@ -410,7 +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.
+  "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.
   "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).
@@ -492,7 +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.
+  "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.
   "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).
@@ -578,7 +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.
+      "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.
       "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).
@@ -670,7 +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.
+  "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.
   "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).
@@ -746,7 +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.
+  "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.
   "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).
@@ -834,7 +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.
+      "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.
       "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).
@@ -947,7 +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.
+    "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.
     "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).
@@ -1022,7 +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.
+  "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.
   "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.messages.html b/docs/dyn/chat_v1.spaces.messages.html
index 5af2d30b1c5..24d6d7ca5d5 100644
--- a/docs/dyn/chat_v1.spaces.messages.html
+++ b/docs/dyn/chat_v1.spaces.messages.html
@@ -2361,7 +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.
+    "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.
     "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).
@@ -4681,7 +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.
+    "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.
     "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).
@@ -7019,7 +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.
+    "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.
     "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).
@@ -9345,7 +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.
+        "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.
         "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).
@@ -11676,7 +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.
+    "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.
     "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).
@@ -13990,7 +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.
+    "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.
     "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).
@@ -16304,7 +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.
+    "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.
     "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).
@@ -18618,7 +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.
+    "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.
     "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 8deb73af2be..57945450ee4 100644
--- a/docs/dyn/chat_v1.spaces.spaceEvents.html
+++ b/docs/dyn/chat_v1.spaces.spaceEvents.html
@@ -2476,7 +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.
+            "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.
             "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).
@@ -4785,7 +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.
+            "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.
             "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).
@@ -7094,7 +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.
+            "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.
             "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).
@@ -9401,7 +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.
+        "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.
         "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).
@@ -11706,7 +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.
+        "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.
         "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).
@@ -14011,7 +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.
+        "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.
         "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).
@@ -14196,7 +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.
+          "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.
           "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).
@@ -14265,7 +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.
+      "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.
       "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).
@@ -16717,7 +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.
+                "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.
                 "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).
@@ -19026,7 +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.
+                "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.
                 "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).
@@ -21335,7 +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.
+                "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.
                 "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).
@@ -23642,7 +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.
+            "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.
             "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).
@@ -25947,7 +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.
+            "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.
             "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).
@@ -28252,7 +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.
+            "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.
             "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).
@@ -28437,7 +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.
+              "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.
               "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).
@@ -28506,7 +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.
+          "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.
           "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/dataplex_v1.projects.locations.aspectTypes.html b/docs/dyn/dataplex_v1.projects.locations.aspectTypes.html
index d6cbb405804..a5c7bed8134 100644
--- a/docs/dyn/dataplex_v1.projects.locations.aspectTypes.html
+++ b/docs/dyn/dataplex_v1.projects.locations.aspectTypes.html
@@ -121,7 +121,7 @@ 
Method Details

 
 { # AspectType is a template for creating Aspects, and represents the JSON-schema for a given Entry, for example, BigQuery Table Schema.
   "authorization": { # Authorization for an AspectType. # Immutable. Defines the Authorization for this type.
-    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the EntryGroup to allow access to instantiate Aspects of Dataplex owned AspectTypes, only settable for Dataplex owned Types.
+    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the EntryGroup to allow access to instantiate Aspects of Dataplex Universal Catalog owned AspectTypes, only settable for Dataplex Universal Catalog owned Types.
   },
   "createTime": "A String", # Output only. The time when the AspectType was created.
   "description": "A String", # Optional. Description of the AspectType.
@@ -251,7 +251,7 @@ 
Method Details

 
     { # AspectType is a template for creating Aspects, and represents the JSON-schema for a given Entry, for example, BigQuery Table Schema.
   "authorization": { # Authorization for an AspectType. # Immutable. Defines the Authorization for this type.
-    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the EntryGroup to allow access to instantiate Aspects of Dataplex owned AspectTypes, only settable for Dataplex owned Types.
+    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the EntryGroup to allow access to instantiate Aspects of Dataplex Universal Catalog owned AspectTypes, only settable for Dataplex Universal Catalog owned Types.
   },
   "createTime": "A String", # Output only. The time when the AspectType was created.
   "description": "A String", # Optional. Description of the AspectType.
@@ -369,7 +369,7 @@ 
Method Details

   "aspectTypes": [ # AspectTypes under the given parent location.
     { # AspectType is a template for creating Aspects, and represents the JSON-schema for a given Entry, for example, BigQuery Table Schema.
       "authorization": { # Authorization for an AspectType. # Immutable. Defines the Authorization for this type.
-        "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the EntryGroup to allow access to instantiate Aspects of Dataplex owned AspectTypes, only settable for Dataplex owned Types.
+        "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the EntryGroup to allow access to instantiate Aspects of Dataplex Universal Catalog owned AspectTypes, only settable for Dataplex Universal Catalog owned Types.
       },
       "createTime": "A String", # Output only. The time when the AspectType was created.
       "description": "A String", # Optional. Description of the AspectType.
@@ -448,7 +448,7 @@ 
Method Details

 
 { # AspectType is a template for creating Aspects, and represents the JSON-schema for a given Entry, for example, BigQuery Table Schema.
   "authorization": { # Authorization for an AspectType. # Immutable. Defines the Authorization for this type.
-    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the EntryGroup to allow access to instantiate Aspects of Dataplex owned AspectTypes, only settable for Dataplex owned Types.
+    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the EntryGroup to allow access to instantiate Aspects of Dataplex Universal Catalog owned AspectTypes, only settable for Dataplex Universal Catalog owned Types.
   },
   "createTime": "A String", # Output only. The time when the AspectType was created.
   "description": "A String", # Optional. Description of the AspectType.
diff --git a/docs/dyn/dataplex_v1.projects.locations.dataScans.html b/docs/dyn/dataplex_v1.projects.locations.dataScans.html
index 381cb08523d..8ce055594f0 100644
--- a/docs/dyn/dataplex_v1.projects.locations.dataScans.html
+++ b/docs/dyn/dataplex_v1.projects.locations.dataScans.html
@@ -133,7 +133,7 @@ 
Method Details

 { # Represents a user-visible job which provides the insights for the related data source.For example: Data quality: generates queries based on the rules and runs against the data to get data quality check results. For more information, see Auto data quality overview (https://cloud.google.com/dataplex/docs/auto-data-quality-overview). Data profile: analyzes the data in tables and generates insights about the structure, content and relationships (such as null percent, cardinality, min/max/mean, etc). For more information, see About data profiling (https://cloud.google.com/dataplex/docs/data-profiling-overview). Data discovery: scans data in Cloud Storage buckets to extract and then catalog metadata. For more information, see Discover and catalog Cloud Storage data (https://cloud.google.com/bigquery/docs/automatic-discovery).
   "createTime": "A String", # Output only. The time when the scan was created.
   "data": { # The data source for DataScan. # Required. The data source for DataScan.
-    "entity": "A String", # Immutable. The Dataplex entity that represents the data source (e.g. BigQuery table) for DataScan, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}.
+    "entity": "A String", # Immutable. The Dataplex Universal Catalog entity that represents the data source (e.g. BigQuery table) for DataScan, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}.
     "resource": "A String", # Immutable. The service-qualified full resource name of the cloud resource for a DataScan job to scan against. The field could either be: Cloud Storage bucket for DataDiscoveryScan Format: //storage.googleapis.com/projects/PROJECT_ID/buckets/BUCKET_ID or BigQuery table of type "TABLE" for DataProfileScan/DataQualityScan Format: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
   },
   "dataDiscoveryResult": { # The output of a data discovery scan. # Output only. The result of a data discovery scan.
@@ -226,7 +226,7 @@ 
Method Details

               },
             ],
           },
-          "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
+          "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Universal Catalog Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
         },
       ],
     },
@@ -259,7 +259,7 @@ 
Method Details

     "samplingPercent": 3.14, # Optional. The percentage of the records to be selected from the dataset for DataScan. Value can range between 0.0 and 100.0 with up to 3 significant decimal digits. Sampling is not applied if sampling_percent is not specified, 0 or 100.
   },
   "dataQualityResult": { # The output of a DataQualityScan. # Output only. The result of a data quality scan.
-    "catalogPublishingStatus": { # The status of publishing the data scan result to Catalog. # Output only. The status of publishing the data scan to Catalog.
+    "catalogPublishingStatus": { # The status of publishing the data scan result as Dataplex Universal Catalog metadata. # Output only. The status of publishing the data scan as Dataplex Universal Catalog metadata.
       "state": "A String", # Output only. Execution state for catalog publishing.
     },
     "columns": [ # Output only. A list of results at the column level.A column will have a corresponding DataQualityColumnResult if and only if there is at least one rule with the 'column' field set to it.
@@ -359,7 +359,7 @@ 
Method Details

     "score": 3.14, # Output only. The overall data quality score.The score ranges between 0, 100 (up to two decimal points).
   },
   "dataQualitySpec": { # DataQualityScan related setting. # Settings for a data quality scan.
-    "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published to Dataplex Catalog.
+    "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published as Dataplex Universal Catalog metadata.
     "postScanActions": { # The configuration of post scan actions of DataQualityScan. # Optional. Actions to take upon job completion.
       "bigqueryExport": { # The configuration of BigQuery export post scan action. # Optional. If set, results will be exported to the provided BigQuery table.
         "resultsTable": "A String", # Optional. The BigQuery table to export DataQualityScan results to. Format: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID or projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
@@ -542,7 +542,7 @@ 
Method Details

   An object of the form:
 
     { # Response details for data quality rule recommendations.
-  "rule": [ # The data quality rules that Dataplex generates based on the results of a data profiling scan.
+  "rule": [ # The data quality rules that Dataplex Universal Catalog generates based on the results of a data profiling scan.
     { # A rule captures data quality intent about a data source.
       "column": "A String", # Optional. The unnested column which this rule is evaluated against.
       "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters.
@@ -612,7 +612,7 @@ 
Method Details

     { # Represents a user-visible job which provides the insights for the related data source.For example: Data quality: generates queries based on the rules and runs against the data to get data quality check results. For more information, see Auto data quality overview (https://cloud.google.com/dataplex/docs/auto-data-quality-overview). Data profile: analyzes the data in tables and generates insights about the structure, content and relationships (such as null percent, cardinality, min/max/mean, etc). For more information, see About data profiling (https://cloud.google.com/dataplex/docs/data-profiling-overview). Data discovery: scans data in Cloud Storage buckets to extract and then catalog metadata. For more information, see Discover and catalog Cloud Storage data (https://cloud.google.com/bigquery/docs/automatic-discovery).
   "createTime": "A String", # Output only. The time when the scan was created.
   "data": { # The data source for DataScan. # Required. The data source for DataScan.
-    "entity": "A String", # Immutable. The Dataplex entity that represents the data source (e.g. BigQuery table) for DataScan, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}.
+    "entity": "A String", # Immutable. The Dataplex Universal Catalog entity that represents the data source (e.g. BigQuery table) for DataScan, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}.
     "resource": "A String", # Immutable. The service-qualified full resource name of the cloud resource for a DataScan job to scan against. The field could either be: Cloud Storage bucket for DataDiscoveryScan Format: //storage.googleapis.com/projects/PROJECT_ID/buckets/BUCKET_ID or BigQuery table of type "TABLE" for DataProfileScan/DataQualityScan Format: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
   },
   "dataDiscoveryResult": { # The output of a data discovery scan. # Output only. The result of a data discovery scan.
@@ -705,7 +705,7 @@ 
Method Details

               },
             ],
           },
-          "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
+          "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Universal Catalog Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
         },
       ],
     },
@@ -738,7 +738,7 @@ 
Method Details

     "samplingPercent": 3.14, # Optional. The percentage of the records to be selected from the dataset for DataScan. Value can range between 0.0 and 100.0 with up to 3 significant decimal digits. Sampling is not applied if sampling_percent is not specified, 0 or 100.
   },
   "dataQualityResult": { # The output of a DataQualityScan. # Output only. The result of a data quality scan.
-    "catalogPublishingStatus": { # The status of publishing the data scan result to Catalog. # Output only. The status of publishing the data scan to Catalog.
+    "catalogPublishingStatus": { # The status of publishing the data scan result as Dataplex Universal Catalog metadata. # Output only. The status of publishing the data scan as Dataplex Universal Catalog metadata.
       "state": "A String", # Output only. Execution state for catalog publishing.
     },
     "columns": [ # Output only. A list of results at the column level.A column will have a corresponding DataQualityColumnResult if and only if there is at least one rule with the 'column' field set to it.
@@ -838,7 +838,7 @@ 
Method Details

     "score": 3.14, # Output only. The overall data quality score.The score ranges between 0, 100 (up to two decimal points).
   },
   "dataQualitySpec": { # DataQualityScan related setting. # Settings for a data quality scan.
-    "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published to Dataplex Catalog.
+    "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published as Dataplex Universal Catalog metadata.
     "postScanActions": { # The configuration of post scan actions of DataQualityScan. # Optional. Actions to take upon job completion.
       "bigqueryExport": { # The configuration of BigQuery export post scan action. # Optional. If set, results will be exported to the provided BigQuery table.
         "resultsTable": "A String", # Optional. The BigQuery table to export DataQualityScan results to. Format: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID or projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
@@ -1005,7 +1005,7 @@ 
Method Details

     { # Represents a user-visible job which provides the insights for the related data source.For example: Data quality: generates queries based on the rules and runs against the data to get data quality check results. For more information, see Auto data quality overview (https://cloud.google.com/dataplex/docs/auto-data-quality-overview). Data profile: analyzes the data in tables and generates insights about the structure, content and relationships (such as null percent, cardinality, min/max/mean, etc). For more information, see About data profiling (https://cloud.google.com/dataplex/docs/data-profiling-overview). Data discovery: scans data in Cloud Storage buckets to extract and then catalog metadata. For more information, see Discover and catalog Cloud Storage data (https://cloud.google.com/bigquery/docs/automatic-discovery).
       "createTime": "A String", # Output only. The time when the scan was created.
       "data": { # The data source for DataScan. # Required. The data source for DataScan.
-        "entity": "A String", # Immutable. The Dataplex entity that represents the data source (e.g. BigQuery table) for DataScan, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}.
+        "entity": "A String", # Immutable. The Dataplex Universal Catalog entity that represents the data source (e.g. BigQuery table) for DataScan, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}.
         "resource": "A String", # Immutable. The service-qualified full resource name of the cloud resource for a DataScan job to scan against. The field could either be: Cloud Storage bucket for DataDiscoveryScan Format: //storage.googleapis.com/projects/PROJECT_ID/buckets/BUCKET_ID or BigQuery table of type "TABLE" for DataProfileScan/DataQualityScan Format: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
       },
       "dataDiscoveryResult": { # The output of a data discovery scan. # Output only. The result of a data discovery scan.
@@ -1098,7 +1098,7 @@ 
Method Details

                   },
                 ],
               },
-              "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
+              "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Universal Catalog Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
             },
           ],
         },
@@ -1131,7 +1131,7 @@ 
Method Details

         "samplingPercent": 3.14, # Optional. The percentage of the records to be selected from the dataset for DataScan. Value can range between 0.0 and 100.0 with up to 3 significant decimal digits. Sampling is not applied if sampling_percent is not specified, 0 or 100.
       },
       "dataQualityResult": { # The output of a DataQualityScan. # Output only. The result of a data quality scan.
-        "catalogPublishingStatus": { # The status of publishing the data scan result to Catalog. # Output only. The status of publishing the data scan to Catalog.
+        "catalogPublishingStatus": { # The status of publishing the data scan result as Dataplex Universal Catalog metadata. # Output only. The status of publishing the data scan as Dataplex Universal Catalog metadata.
           "state": "A String", # Output only. Execution state for catalog publishing.
         },
         "columns": [ # Output only. A list of results at the column level.A column will have a corresponding DataQualityColumnResult if and only if there is at least one rule with the 'column' field set to it.
@@ -1231,7 +1231,7 @@ 
Method Details

         "score": 3.14, # Output only. The overall data quality score.The score ranges between 0, 100 (up to two decimal points).
       },
       "dataQualitySpec": { # DataQualityScan related setting. # Settings for a data quality scan.
-        "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published to Dataplex Catalog.
+        "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published as Dataplex Universal Catalog metadata.
         "postScanActions": { # The configuration of post scan actions of DataQualityScan. # Optional. Actions to take upon job completion.
           "bigqueryExport": { # The configuration of BigQuery export post scan action. # Optional. If set, results will be exported to the provided BigQuery table.
             "resultsTable": "A String", # Optional. The BigQuery table to export DataQualityScan results to. Format: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID or projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
@@ -1359,7 +1359,7 @@ 
Method Details

 { # Represents a user-visible job which provides the insights for the related data source.For example: Data quality: generates queries based on the rules and runs against the data to get data quality check results. For more information, see Auto data quality overview (https://cloud.google.com/dataplex/docs/auto-data-quality-overview). Data profile: analyzes the data in tables and generates insights about the structure, content and relationships (such as null percent, cardinality, min/max/mean, etc). For more information, see About data profiling (https://cloud.google.com/dataplex/docs/data-profiling-overview). Data discovery: scans data in Cloud Storage buckets to extract and then catalog metadata. For more information, see Discover and catalog Cloud Storage data (https://cloud.google.com/bigquery/docs/automatic-discovery).
   "createTime": "A String", # Output only. The time when the scan was created.
   "data": { # The data source for DataScan. # Required. The data source for DataScan.
-    "entity": "A String", # Immutable. The Dataplex entity that represents the data source (e.g. BigQuery table) for DataScan, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}.
+    "entity": "A String", # Immutable. The Dataplex Universal Catalog entity that represents the data source (e.g. BigQuery table) for DataScan, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}.
     "resource": "A String", # Immutable. The service-qualified full resource name of the cloud resource for a DataScan job to scan against. The field could either be: Cloud Storage bucket for DataDiscoveryScan Format: //storage.googleapis.com/projects/PROJECT_ID/buckets/BUCKET_ID or BigQuery table of type "TABLE" for DataProfileScan/DataQualityScan Format: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
   },
   "dataDiscoveryResult": { # The output of a data discovery scan. # Output only. The result of a data discovery scan.
@@ -1452,7 +1452,7 @@ 
Method Details

               },
             ],
           },
-          "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
+          "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Universal Catalog Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
         },
       ],
     },
@@ -1485,7 +1485,7 @@ 
Method Details

     "samplingPercent": 3.14, # Optional. The percentage of the records to be selected from the dataset for DataScan. Value can range between 0.0 and 100.0 with up to 3 significant decimal digits. Sampling is not applied if sampling_percent is not specified, 0 or 100.
   },
   "dataQualityResult": { # The output of a DataQualityScan. # Output only. The result of a data quality scan.
-    "catalogPublishingStatus": { # The status of publishing the data scan result to Catalog. # Output only. The status of publishing the data scan to Catalog.
+    "catalogPublishingStatus": { # The status of publishing the data scan result as Dataplex Universal Catalog metadata. # Output only. The status of publishing the data scan as Dataplex Universal Catalog metadata.
       "state": "A String", # Output only. Execution state for catalog publishing.
     },
     "columns": [ # Output only. A list of results at the column level.A column will have a corresponding DataQualityColumnResult if and only if there is at least one rule with the 'column' field set to it.
@@ -1585,7 +1585,7 @@ 
Method Details

     "score": 3.14, # Output only. The overall data quality score.The score ranges between 0, 100 (up to two decimal points).
   },
   "dataQualitySpec": { # DataQualityScan related setting. # Settings for a data quality scan.
-    "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published to Dataplex Catalog.
+    "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published as Dataplex Universal Catalog metadata.
     "postScanActions": { # The configuration of post scan actions of DataQualityScan. # Optional. Actions to take upon job completion.
       "bigqueryExport": { # The configuration of BigQuery export post scan action. # Optional. If set, results will be exported to the provided BigQuery table.
         "resultsTable": "A String", # Optional. The BigQuery table to export DataQualityScan results to. Format: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID or projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
@@ -1824,7 +1824,7 @@ 
Method Details

                 },
               ],
             },
-            "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
+            "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Universal Catalog Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
           },
         ],
       },
@@ -1857,7 +1857,7 @@ 
Method Details

       "samplingPercent": 3.14, # Optional. The percentage of the records to be selected from the dataset for DataScan. Value can range between 0.0 and 100.0 with up to 3 significant decimal digits. Sampling is not applied if sampling_percent is not specified, 0 or 100.
     },
     "dataQualityResult": { # The output of a DataQualityScan. # Output only. The result of a data quality scan.
-      "catalogPublishingStatus": { # The status of publishing the data scan result to Catalog. # Output only. The status of publishing the data scan to Catalog.
+      "catalogPublishingStatus": { # The status of publishing the data scan result as Dataplex Universal Catalog metadata. # Output only. The status of publishing the data scan as Dataplex Universal Catalog metadata.
         "state": "A String", # Output only. Execution state for catalog publishing.
       },
       "columns": [ # Output only. A list of results at the column level.A column will have a corresponding DataQualityColumnResult if and only if there is at least one rule with the 'column' field set to it.
@@ -1957,7 +1957,7 @@ 
Method Details

       "score": 3.14, # Output only. The overall data quality score.The score ranges between 0, 100 (up to two decimal points).
     },
     "dataQualitySpec": { # DataQualityScan related setting. # Output only. Settings for a data quality scan.
-      "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published to Dataplex Catalog.
+      "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published as Dataplex Universal Catalog metadata.
       "postScanActions": { # The configuration of post scan actions of DataQualityScan. # Optional. Actions to take upon job completion.
         "bigqueryExport": { # The configuration of BigQuery export post scan action. # Optional. If set, results will be exported to the provided BigQuery table.
           "resultsTable": "A String", # Optional. The BigQuery table to export DataQualityScan results to. Format: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID or projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
diff --git a/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html b/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html
index 9ccba1c42cf..412a117defb 100644
--- a/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html
+++ b/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html
@@ -116,7 +116,7 @@ 
Method Details

   An object of the form:
 
     { # Response details for data quality rule recommendations.
-  "rule": [ # The data quality rules that Dataplex generates based on the results of a data profiling scan.
+  "rule": [ # The data quality rules that Dataplex Universal Catalog generates based on the results of a data profiling scan.
     { # A rule captures data quality intent about a data source.
       "column": "A String", # Optional. The unnested column which this rule is evaluated against.
       "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters.
@@ -275,7 +275,7 @@ 
Method Details

               },
             ],
           },
-          "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
+          "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Universal Catalog Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
         },
       ],
     },
@@ -308,7 +308,7 @@ 
Method Details

     "samplingPercent": 3.14, # Optional. The percentage of the records to be selected from the dataset for DataScan. Value can range between 0.0 and 100.0 with up to 3 significant decimal digits. Sampling is not applied if sampling_percent is not specified, 0 or 100.
   },
   "dataQualityResult": { # The output of a DataQualityScan. # Output only. The result of a data quality scan.
-    "catalogPublishingStatus": { # The status of publishing the data scan result to Catalog. # Output only. The status of publishing the data scan to Catalog.
+    "catalogPublishingStatus": { # The status of publishing the data scan result as Dataplex Universal Catalog metadata. # Output only. The status of publishing the data scan as Dataplex Universal Catalog metadata.
       "state": "A String", # Output only. Execution state for catalog publishing.
     },
     "columns": [ # Output only. A list of results at the column level.A column will have a corresponding DataQualityColumnResult if and only if there is at least one rule with the 'column' field set to it.
@@ -408,7 +408,7 @@ 
Method Details

     "score": 3.14, # Output only. The overall data quality score.The score ranges between 0, 100 (up to two decimal points).
   },
   "dataQualitySpec": { # DataQualityScan related setting. # Output only. Settings for a data quality scan.
-    "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published to Dataplex Catalog.
+    "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published as Dataplex Universal Catalog metadata.
     "postScanActions": { # The configuration of post scan actions of DataQualityScan. # Optional. Actions to take upon job completion.
       "bigqueryExport": { # The configuration of BigQuery export post scan action. # Optional. If set, results will be exported to the provided BigQuery table.
         "resultsTable": "A String", # Optional. The BigQuery table to export DataQualityScan results to. Format: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID or projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
@@ -597,7 +597,7 @@ 
Method Details

                   },
                 ],
               },
-              "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
+              "type": "A String", # The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Universal Catalog Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).
             },
           ],
         },
@@ -630,7 +630,7 @@ 
Method Details

         "samplingPercent": 3.14, # Optional. The percentage of the records to be selected from the dataset for DataScan. Value can range between 0.0 and 100.0 with up to 3 significant decimal digits. Sampling is not applied if sampling_percent is not specified, 0 or 100.
       },
       "dataQualityResult": { # The output of a DataQualityScan. # Output only. The result of a data quality scan.
-        "catalogPublishingStatus": { # The status of publishing the data scan result to Catalog. # Output only. The status of publishing the data scan to Catalog.
+        "catalogPublishingStatus": { # The status of publishing the data scan result as Dataplex Universal Catalog metadata. # Output only. The status of publishing the data scan as Dataplex Universal Catalog metadata.
           "state": "A String", # Output only. Execution state for catalog publishing.
         },
         "columns": [ # Output only. A list of results at the column level.A column will have a corresponding DataQualityColumnResult if and only if there is at least one rule with the 'column' field set to it.
@@ -730,7 +730,7 @@ 
Method Details

         "score": 3.14, # Output only. The overall data quality score.The score ranges between 0, 100 (up to two decimal points).
       },
       "dataQualitySpec": { # DataQualityScan related setting. # Output only. Settings for a data quality scan.
-        "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published to Dataplex Catalog.
+        "catalogPublishingEnabled": True or False, # Optional. If set, the latest DataScan job result will be published as Dataplex Universal Catalog metadata.
         "postScanActions": { # The configuration of post scan actions of DataQualityScan. # Optional. Actions to take upon job completion.
           "bigqueryExport": { # The configuration of BigQuery export post scan action. # Optional. If set, results will be exported to the provided BigQuery table.
             "resultsTable": "A String", # Optional. The BigQuery table to export DataQualityScan results to. Format: //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID or projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
diff --git a/docs/dyn/dataplex_v1.projects.locations.entryGroups.entries.html b/docs/dyn/dataplex_v1.projects.locations.entryGroups.entries.html
index 43b8d9c3da4..4d0dafc7503 100644
--- a/docs/dyn/dataplex_v1.projects.locations.entryGroups.entries.html
+++ b/docs/dyn/dataplex_v1.projects.locations.entryGroups.entries.html
@@ -127,7 +127,7 @@ 
Method Details

       "updateTime": "A String", # Output only. The time when the Aspect was last updated.
     },
   },
-  "createTime": "A String", # Output only. The time when the entry was created in Dataplex.
+  "createTime": "A String", # Output only. The time when the entry was created in Dataplex Universal Catalog.
   "entrySource": { # Information related to the source system of the data resource that is represented by the entry. # Optional. Information related to the source system of the data resource that is represented by the entry.
     "ancestors": [ # Immutable. The entries representing the ancestors of the data resource in the source system.
       { # Information about individual items in the hierarchy that is associated with the data resource.
@@ -151,7 +151,7 @@ 
Method Details

   "fullyQualifiedName": "A String", # Optional. A name for the entry that can be referenced by an external system. For more information, see Fully qualified names (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The maximum size of the field is 4000 characters.
   "name": "A String", # Identifier. The relative resource name of the entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
   "parentEntry": "A String", # Optional. Immutable. The resource name of the parent entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
-  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex.
+  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex Universal Catalog.
 }
 
   entryId: string, Required. Entry identifier. It has to be unique within an Entry Group.Entries corresponding to Google Cloud resources use an Entry ID format based on full resource names (https://cloud.google.com/apis/design/resource_names#full_resource_name). The format is a full resource name of the resource without the prefix double slashes in the API service name part of the full resource name. This allows retrieval of entries using their associated resource name.For example, if the full resource name of a resource is //library.googleapis.com/shelves/shelf1/books/book2, then the suggested entry_id is library.googleapis.com/shelves/shelf1/books/book2.It is also suggested to follow the same convention for entries corresponding to resources from providers or systems other than Google Cloud.The maximum size of the field is 4000 characters.
@@ -180,7 +180,7 @@ 
Method Details

       "updateTime": "A String", # Output only. The time when the Aspect was last updated.
     },
   },
-  "createTime": "A String", # Output only. The time when the entry was created in Dataplex.
+  "createTime": "A String", # Output only. The time when the entry was created in Dataplex Universal Catalog.
   "entrySource": { # Information related to the source system of the data resource that is represented by the entry. # Optional. Information related to the source system of the data resource that is represented by the entry.
     "ancestors": [ # Immutable. The entries representing the ancestors of the data resource in the source system.
       { # Information about individual items in the hierarchy that is associated with the data resource.
@@ -204,7 +204,7 @@ 
Method Details

   "fullyQualifiedName": "A String", # Optional. A name for the entry that can be referenced by an external system. For more information, see Fully qualified names (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The maximum size of the field is 4000 characters.
   "name": "A String", # Identifier. The relative resource name of the entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
   "parentEntry": "A String", # Optional. Immutable. The resource name of the parent entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
-  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex.
+  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex Universal Catalog.
 }

 
 
@@ -239,7 +239,7 @@ 
Method Details

       "updateTime": "A String", # Output only. The time when the Aspect was last updated.
     },
   },
-  "createTime": "A String", # Output only. The time when the entry was created in Dataplex.
+  "createTime": "A String", # Output only. The time when the entry was created in Dataplex Universal Catalog.
   "entrySource": { # Information related to the source system of the data resource that is represented by the entry. # Optional. Information related to the source system of the data resource that is represented by the entry.
     "ancestors": [ # Immutable. The entries representing the ancestors of the data resource in the source system.
       { # Information about individual items in the hierarchy that is associated with the data resource.
@@ -263,7 +263,7 @@ 
Method Details

   "fullyQualifiedName": "A String", # Optional. A name for the entry that can be referenced by an external system. For more information, see Fully qualified names (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The maximum size of the field is 4000 characters.
   "name": "A String", # Identifier. The relative resource name of the entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
   "parentEntry": "A String", # Optional. Immutable. The resource name of the parent entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
-  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex.
+  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex Universal Catalog.
 }

 
 
@@ -307,7 +307,7 @@ 
Method Details

       "updateTime": "A String", # Output only. The time when the Aspect was last updated.
     },
   },
-  "createTime": "A String", # Output only. The time when the entry was created in Dataplex.
+  "createTime": "A String", # Output only. The time when the entry was created in Dataplex Universal Catalog.
   "entrySource": { # Information related to the source system of the data resource that is represented by the entry. # Optional. Information related to the source system of the data resource that is represented by the entry.
     "ancestors": [ # Immutable. The entries representing the ancestors of the data resource in the source system.
       { # Information about individual items in the hierarchy that is associated with the data resource.
@@ -331,7 +331,7 @@ 
Method Details

   "fullyQualifiedName": "A String", # Optional. A name for the entry that can be referenced by an external system. For more information, see Fully qualified names (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The maximum size of the field is 4000 characters.
   "name": "A String", # Identifier. The relative resource name of the entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
   "parentEntry": "A String", # Optional. Immutable. The resource name of the parent entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
-  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex.
+  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex Universal Catalog.
 }

 
 
@@ -371,7 +371,7 @@ 
Method Details

           "updateTime": "A String", # Output only. The time when the Aspect was last updated.
         },
       },
-      "createTime": "A String", # Output only. The time when the entry was created in Dataplex.
+      "createTime": "A String", # Output only. The time when the entry was created in Dataplex Universal Catalog.
       "entrySource": { # Information related to the source system of the data resource that is represented by the entry. # Optional. Information related to the source system of the data resource that is represented by the entry.
         "ancestors": [ # Immutable. The entries representing the ancestors of the data resource in the source system.
           { # Information about individual items in the hierarchy that is associated with the data resource.
@@ -395,7 +395,7 @@ 
Method Details

       "fullyQualifiedName": "A String", # Optional. A name for the entry that can be referenced by an external system. For more information, see Fully qualified names (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The maximum size of the field is 4000 characters.
       "name": "A String", # Identifier. The relative resource name of the entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
       "parentEntry": "A String", # Optional. Immutable. The resource name of the parent entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
-      "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex.
+      "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex Universal Catalog.
     },
   ],
   "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more results in the list.
@@ -442,7 +442,7 @@ 
Method Details

       "updateTime": "A String", # Output only. The time when the Aspect was last updated.
     },
   },
-  "createTime": "A String", # Output only. The time when the entry was created in Dataplex.
+  "createTime": "A String", # Output only. The time when the entry was created in Dataplex Universal Catalog.
   "entrySource": { # Information related to the source system of the data resource that is represented by the entry. # Optional. Information related to the source system of the data resource that is represented by the entry.
     "ancestors": [ # Immutable. The entries representing the ancestors of the data resource in the source system.
       { # Information about individual items in the hierarchy that is associated with the data resource.
@@ -466,7 +466,7 @@ 
Method Details

   "fullyQualifiedName": "A String", # Optional. A name for the entry that can be referenced by an external system. For more information, see Fully qualified names (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The maximum size of the field is 4000 characters.
   "name": "A String", # Identifier. The relative resource name of the entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
   "parentEntry": "A String", # Optional. Immutable. The resource name of the parent entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
-  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex.
+  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex Universal Catalog.
 }
 
   allowMissing: boolean, Optional. If set to true and the entry doesn't exist, the service will create it.
@@ -498,7 +498,7 @@ 
Method Details

       "updateTime": "A String", # Output only. The time when the Aspect was last updated.
     },
   },
-  "createTime": "A String", # Output only. The time when the entry was created in Dataplex.
+  "createTime": "A String", # Output only. The time when the entry was created in Dataplex Universal Catalog.
   "entrySource": { # Information related to the source system of the data resource that is represented by the entry. # Optional. Information related to the source system of the data resource that is represented by the entry.
     "ancestors": [ # Immutable. The entries representing the ancestors of the data resource in the source system.
       { # Information about individual items in the hierarchy that is associated with the data resource.
@@ -522,7 +522,7 @@ 
Method Details

   "fullyQualifiedName": "A String", # Optional. A name for the entry that can be referenced by an external system. For more information, see Fully qualified names (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The maximum size of the field is 4000 characters.
   "name": "A String", # Identifier. The relative resource name of the entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
   "parentEntry": "A String", # Optional. Immutable. The resource name of the parent entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
-  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex.
+  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex Universal Catalog.
 }

 
 
diff --git a/docs/dyn/dataplex_v1.projects.locations.entryTypes.html b/docs/dyn/dataplex_v1.projects.locations.entryTypes.html
index b8aec4f831d..acdaf951461 100644
--- a/docs/dyn/dataplex_v1.projects.locations.entryTypes.html
+++ b/docs/dyn/dataplex_v1.projects.locations.entryTypes.html
@@ -121,7 +121,7 @@ 
Method Details

 
 { # Entry Type is a template for creating Entries.
   "authorization": { # Authorization for an Entry Type. # Immutable. Authorization defined for this type.
-    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the Entry Group to allow access to instantiate Entries of Dataplex owned Entry Types, only settable for Dataplex owned Types.
+    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the Entry Group to allow access to instantiate Entries of Dataplex Universal Catalog owned Entry Types, only settable for Dataplex Universal Catalog owned Types.
   },
   "createTime": "A String", # Output only. The time when the EntryType was created.
   "description": "A String", # Optional. Description of the EntryType.
@@ -228,7 +228,7 @@ 
Method Details

 
     { # Entry Type is a template for creating Entries.
   "authorization": { # Authorization for an Entry Type. # Immutable. Authorization defined for this type.
-    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the Entry Group to allow access to instantiate Entries of Dataplex owned Entry Types, only settable for Dataplex owned Types.
+    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the Entry Group to allow access to instantiate Entries of Dataplex Universal Catalog owned Entry Types, only settable for Dataplex Universal Catalog owned Types.
   },
   "createTime": "A String", # Output only. The time when the EntryType was created.
   "description": "A String", # Optional. Description of the EntryType.
@@ -323,7 +323,7 @@ 
Method Details

   "entryTypes": [ # EntryTypes under the given parent location.
     { # Entry Type is a template for creating Entries.
       "authorization": { # Authorization for an Entry Type. # Immutable. Authorization defined for this type.
-        "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the Entry Group to allow access to instantiate Entries of Dataplex owned Entry Types, only settable for Dataplex owned Types.
+        "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the Entry Group to allow access to instantiate Entries of Dataplex Universal Catalog owned Entry Types, only settable for Dataplex Universal Catalog owned Types.
       },
       "createTime": "A String", # Output only. The time when the EntryType was created.
       "description": "A String", # Optional. Description of the EntryType.
@@ -379,7 +379,7 @@ 
Method Details

 
 { # Entry Type is a template for creating Entries.
   "authorization": { # Authorization for an Entry Type. # Immutable. Authorization defined for this type.
-    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the Entry Group to allow access to instantiate Entries of Dataplex owned Entry Types, only settable for Dataplex owned Types.
+    "alternateUsePermission": "A String", # Immutable. The IAM permission grantable on the Entry Group to allow access to instantiate Entries of Dataplex Universal Catalog owned Entry Types, only settable for Dataplex Universal Catalog owned Types.
   },
   "createTime": "A String", # Output only. The time when the EntryType was created.
   "description": "A String", # Optional. Description of the EntryType.
diff --git a/docs/dyn/dataplex_v1.projects.locations.html b/docs/dyn/dataplex_v1.projects.locations.html
index e59f9fd9647..a9cc58a8dae 100644
--- a/docs/dyn/dataplex_v1.projects.locations.html
+++ b/docs/dyn/dataplex_v1.projects.locations.html
@@ -284,7 +284,7 @@ 
Method Details

       "updateTime": "A String", # Output only. The time when the Aspect was last updated.
     },
   },
-  "createTime": "A String", # Output only. The time when the entry was created in Dataplex.
+  "createTime": "A String", # Output only. The time when the entry was created in Dataplex Universal Catalog.
   "entrySource": { # Information related to the source system of the data resource that is represented by the entry. # Optional. Information related to the source system of the data resource that is represented by the entry.
     "ancestors": [ # Immutable. The entries representing the ancestors of the data resource in the source system.
       { # Information about individual items in the hierarchy that is associated with the data resource.
@@ -308,7 +308,7 @@ 
Method Details

   "fullyQualifiedName": "A String", # Optional. A name for the entry that can be referenced by an external system. For more information, see Fully qualified names (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The maximum size of the field is 4000 characters.
   "name": "A String", # Identifier. The relative resource name of the entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
   "parentEntry": "A String", # Optional. Immutable. The resource name of the parent entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
-  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex.
+  "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex Universal Catalog.
 }

 
 
@@ -321,7 +321,7 @@ 
Method Details

   orderBy: string, Optional. Specifies the ordering of results. Supported values are: relevance (default) last_modified_timestamp last_modified_timestamp asc
   pageSize: integer, Optional. Number of results in the search page. If <=0, then defaults to 10. Max limit for page_size is 1000. Throws an invalid argument for page_size > 1000.
   pageToken: string, Optional. Page token received from a previous SearchEntries call. Provide this to retrieve the subsequent page.
-  query: string, Required. The query against which entries in scope should be matched. The query syntax is defined in Search syntax for Dataplex Catalog (https://cloud.google.com/dataplex/docs/search-syntax).
+  query: string, Required. The query against which entries in scope should be matched. The query syntax is defined in Search syntax for Dataplex Universal Catalog (https://cloud.google.com/dataplex/docs/search-syntax).
   scope: string, Optional. The scope under which the search should be operating. It must either be organizations/ or projects/. If it is unspecified, it defaults to the organization where the project provided in name is located.
   semanticSearch: boolean, Optional. Specifies whether the search should understand the meaning and intent behind the query, rather than just matching keywords.
   x__xgafv: string, V1 error format.
@@ -353,7 +353,7 @@ 
Method Details

             "updateTime": "A String", # Output only. The time when the Aspect was last updated.
           },
         },
-        "createTime": "A String", # Output only. The time when the entry was created in Dataplex.
+        "createTime": "A String", # Output only. The time when the entry was created in Dataplex Universal Catalog.
         "entrySource": { # Information related to the source system of the data resource that is represented by the entry. # Optional. Information related to the source system of the data resource that is represented by the entry.
           "ancestors": [ # Immutable. The entries representing the ancestors of the data resource in the source system.
             { # Information about individual items in the hierarchy that is associated with the data resource.
@@ -377,7 +377,7 @@ 
Method Details

         "fullyQualifiedName": "A String", # Optional. A name for the entry that can be referenced by an external system. For more information, see Fully qualified names (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The maximum size of the field is 4000 characters.
         "name": "A String", # Identifier. The relative resource name of the entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
         "parentEntry": "A String", # Optional. Immutable. The resource name of the parent entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
-        "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex.
+        "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex Universal Catalog.
       },
       "linkedResource": "A String", # Linked resource name.
       "snippets": { # Snippets for the entry, contains HTML-style highlighting for matched tokens, will be used in UI. # Snippets.
@@ -398,7 +398,7 @@ 
Method Details

               "updateTime": "A String", # Output only. The time when the Aspect was last updated.
             },
           },
-          "createTime": "A String", # Output only. The time when the entry was created in Dataplex.
+          "createTime": "A String", # Output only. The time when the entry was created in Dataplex Universal Catalog.
           "entrySource": { # Information related to the source system of the data resource that is represented by the entry. # Optional. Information related to the source system of the data resource that is represented by the entry.
             "ancestors": [ # Immutable. The entries representing the ancestors of the data resource in the source system.
               { # Information about individual items in the hierarchy that is associated with the data resource.
@@ -422,7 +422,7 @@ 
Method Details

           "fullyQualifiedName": "A String", # Optional. A name for the entry that can be referenced by an external system. For more information, see Fully qualified names (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The maximum size of the field is 4000 characters.
           "name": "A String", # Identifier. The relative resource name of the entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
           "parentEntry": "A String", # Optional. Immutable. The resource name of the parent entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}.
-          "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex.
+          "updateTime": "A String", # Output only. The time when the entry was last updated in Dataplex Universal Catalog.
         },
       },
     },
diff --git a/docs/dyn/dataplex_v1.projects.locations.lakes.environments.html b/docs/dyn/dataplex_v1.projects.locations.lakes.environments.html
index 195b8521757..b063a5b6cda 100644
--- a/docs/dyn/dataplex_v1.projects.locations.lakes.environments.html
+++ b/docs/dyn/dataplex_v1.projects.locations.lakes.environments.html
@@ -139,7 +139,7 @@ 
Method Details

       "nodeCount": 42, # Optional. Total number of nodes in the sessions created for this environment.
     },
     "osImage": { # Software Runtime Configuration to run Analyze. # Required. Software Runtime Configuration for analyze interactive workloads.
-      "imageVersion": "A String", # Required. Dataplex Image version.
+      "imageVersion": "A String", # Required. Dataplex Universal Catalog Image version.
       "javaLibraries": [ # Optional. List of Java jars to be included in the runtime environment. Valid input includes Cloud Storage URIs to Jar binaries. For example, gs://bucket-name/my/path/to/file.jar
         "A String",
       ],
@@ -262,7 +262,7 @@ 
Method Details

       "nodeCount": 42, # Optional. Total number of nodes in the sessions created for this environment.
     },
     "osImage": { # Software Runtime Configuration to run Analyze. # Required. Software Runtime Configuration for analyze interactive workloads.
-      "imageVersion": "A String", # Required. Dataplex Image version.
+      "imageVersion": "A String", # Required. Dataplex Universal Catalog Image version.
       "javaLibraries": [ # Optional. List of Java jars to be included in the runtime environment. Valid input includes Cloud Storage URIs to Jar binaries. For example, gs://bucket-name/my/path/to/file.jar
         "A String",
       ],
@@ -374,7 +374,7 @@ 
Method Details

           "nodeCount": 42, # Optional. Total number of nodes in the sessions created for this environment.
         },
         "osImage": { # Software Runtime Configuration to run Analyze. # Required. Software Runtime Configuration for analyze interactive workloads.
-          "imageVersion": "A String", # Required. Dataplex Image version.
+          "imageVersion": "A String", # Required. Dataplex Universal Catalog Image version.
           "javaLibraries": [ # Optional. List of Java jars to be included in the runtime environment. Valid input includes Cloud Storage URIs to Jar binaries. For example, gs://bucket-name/my/path/to/file.jar
             "A String",
           ],
@@ -444,7 +444,7 @@ 
Method Details

       "nodeCount": 42, # Optional. Total number of nodes in the sessions created for this environment.
     },
     "osImage": { # Software Runtime Configuration to run Analyze. # Required. Software Runtime Configuration for analyze interactive workloads.
-      "imageVersion": "A String", # Required. Dataplex Image version.
+      "imageVersion": "A String", # Required. Dataplex Universal Catalog Image version.
       "javaLibraries": [ # Optional. List of Java jars to be included in the runtime environment. Valid input includes Cloud Storage URIs to Jar binaries. For example, gs://bucket-name/my/path/to/file.jar
         "A String",
       ],
diff --git a/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.html b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.html
index 20d568a13c3..3f86a82ce5c 100644
--- a/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.html
+++ b/docs/dyn/dataplex_v1.projects.locations.lakes.zones.entities.html
@@ -175,7 +175,7 @@ 
Method Details

       },
     ],
     "partitionStyle": "A String", # Optional. The structure of paths containing partition data within the entity.
-    "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex. The default is false (managed by Dataplex). Set to falseto enable Dataplex discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex treats schema input by the user as though produced by a previous Dataplex discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex will not change schema fields.
+    "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex Universal Catalog. The default is false (managed by Dataplex Universal Catalog). Set to falseto enable Dataplex Universal Catalog discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex Universal Catalog treats schema input by the user as though produced by a previous Dataplex Universal Catalog discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex Universal Catalog will not change schema fields.
   },
   "system": "A String", # Required. Immutable. Identifies the storage system of the entity data.
   "type": "A String", # Required. Immutable. The type of entity.
@@ -252,7 +252,7 @@ 
Method Details

       },
     ],
     "partitionStyle": "A String", # Optional. The structure of paths containing partition data within the entity.
-    "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex. The default is false (managed by Dataplex). Set to falseto enable Dataplex discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex treats schema input by the user as though produced by a previous Dataplex discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex will not change schema fields.
+    "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex Universal Catalog. The default is false (managed by Dataplex Universal Catalog). Set to falseto enable Dataplex Universal Catalog discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex Universal Catalog treats schema input by the user as though produced by a previous Dataplex Universal Catalog discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex Universal Catalog will not change schema fields.
   },
   "system": "A String", # Required. Immutable. Identifies the storage system of the entity data.
   "type": "A String", # Required. Immutable. The type of entity.
@@ -360,7 +360,7 @@ 
Method Details

       },
     ],
     "partitionStyle": "A String", # Optional. The structure of paths containing partition data within the entity.
-    "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex. The default is false (managed by Dataplex). Set to falseto enable Dataplex discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex treats schema input by the user as though produced by a previous Dataplex discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex will not change schema fields.
+    "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex Universal Catalog. The default is false (managed by Dataplex Universal Catalog). Set to falseto enable Dataplex Universal Catalog discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex Universal Catalog treats schema input by the user as though produced by a previous Dataplex Universal Catalog discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex Universal Catalog will not change schema fields.
   },
   "system": "A String", # Required. Immutable. Identifies the storage system of the entity data.
   "type": "A String", # Required. Immutable. The type of entity.
@@ -453,7 +453,7 @@ 
Method Details

           },
         ],
         "partitionStyle": "A String", # Optional. The structure of paths containing partition data within the entity.
-        "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex. The default is false (managed by Dataplex). Set to falseto enable Dataplex discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex treats schema input by the user as though produced by a previous Dataplex discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex will not change schema fields.
+        "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex Universal Catalog. The default is false (managed by Dataplex Universal Catalog). Set to falseto enable Dataplex Universal Catalog discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex Universal Catalog treats schema input by the user as though produced by a previous Dataplex Universal Catalog discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex Universal Catalog will not change schema fields.
       },
       "system": "A String", # Required. Immutable. Identifies the storage system of the entity data.
       "type": "A String", # Required. Immutable. The type of entity.
@@ -548,7 +548,7 @@ 
Method Details

       },
     ],
     "partitionStyle": "A String", # Optional. The structure of paths containing partition data within the entity.
-    "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex. The default is false (managed by Dataplex). Set to falseto enable Dataplex discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex treats schema input by the user as though produced by a previous Dataplex discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex will not change schema fields.
+    "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex Universal Catalog. The default is false (managed by Dataplex Universal Catalog). Set to falseto enable Dataplex Universal Catalog discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex Universal Catalog treats schema input by the user as though produced by a previous Dataplex Universal Catalog discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex Universal Catalog will not change schema fields.
   },
   "system": "A String", # Required. Immutable. Identifies the storage system of the entity data.
   "type": "A String", # Required. Immutable. The type of entity.
@@ -625,7 +625,7 @@ 
Method Details

       },
     ],
     "partitionStyle": "A String", # Optional. The structure of paths containing partition data within the entity.
-    "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex. The default is false (managed by Dataplex). Set to falseto enable Dataplex discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex treats schema input by the user as though produced by a previous Dataplex discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex will not change schema fields.
+    "userManaged": True or False, # Required. Set to true if user-managed or false if managed by Dataplex Universal Catalog. The default is false (managed by Dataplex Universal Catalog). Set to falseto enable Dataplex Universal Catalog discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex Universal Catalog treats schema input by the user as though produced by a previous Dataplex Universal Catalog discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex Universal Catalog will not change schema fields.
   },
   "system": "A String", # Required. Immutable. Identifies the storage system of the entity data.
   "type": "A String", # Required. Immutable. The type of entity.
diff --git a/docs/dyn/dataplex_v1.projects.locations.metadataJobs.html b/docs/dyn/dataplex_v1.projects.locations.metadataJobs.html
index f2facfb6915..c4d68801634 100644
--- a/docs/dyn/dataplex_v1.projects.locations.metadataJobs.html
+++ b/docs/dyn/dataplex_v1.projects.locations.metadataJobs.html
@@ -82,7 +82,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

   create(parent, body=None, metadataJobId=None, validateOnly=None, x__xgafv=None)

-
Creates a metadata job. For example, use a metadata job to import Dataplex Catalog entries and aspects from a third-party system into Dataplex.

+
Creates a metadata job. For example, use a metadata job to import metadata from a third-party system into Dataplex Universal Catalog.

 

   get(name, x__xgafv=None)

 
Gets a metadata job.

@@ -124,7 +124,7 @@ 
Method Details

 
 

     create(parent, body=None, metadataJobId=None, validateOnly=None, x__xgafv=None)
-  
Creates a metadata job. For example, use a metadata job to import Dataplex Catalog entries and aspects from a third-party system into Dataplex.
+  
Creates a metadata job. For example, use a metadata job to import metadata from a third-party system into Dataplex Universal Catalog.
 
 Args:
   parent: string, Required. The resource name of the parent location, in the format projects/{project_id_or_number}/locations/{location_id} (required)
@@ -138,7 +138,7 @@ 
Method Details

     "exportedEntries": "A String", # Output only. The number of entries that were exported.
   },
   "exportSpec": { # Job specification for a metadata export job. # Export job specification.
-    "outputPath": "A String", # Required. The root path of the Cloud Storage bucket to export the metadata to, in the format gs://{bucket}/. You can optionally specify a custom prefix after the bucket name, in the format gs://{bucket}/{prefix}/. The maximum length of the custom prefix is 128 characters. Dataplex constructs the object path for the exported files by using the bucket name and prefix that you provide, followed by a system-generated path.The bucket must be in the same VPC Service Controls perimeter as the job.
+    "outputPath": "A String", # Required. The root path of the Cloud Storage bucket to export the metadata to, in the format gs://{bucket}/. You can optionally specify a custom prefix after the bucket name, in the format gs://{bucket}/{prefix}/. The maximum length of the custom prefix is 128 characters. Dataplex Universal Catalog constructs the object path for the exported files by using the bucket name and prefix that you provide, followed by a system-generated path.The bucket must be in the same VPC Service Controls perimeter as the job.
     "scope": { # The scope of the export job. # Required. The scope of the export job.
       "aspectTypes": [ # The aspect types that are in scope for the export job, specified as relative resource names in the format projects/{project_id_or_number}/locations/{location}/aspectTypes/{aspect_type_id}. Only aspects that belong to the specified aspect types are affected by the job.
         "A String",
@@ -260,7 +260,7 @@ 
Method Details

     "exportedEntries": "A String", # Output only. The number of entries that were exported.
   },
   "exportSpec": { # Job specification for a metadata export job. # Export job specification.
-    "outputPath": "A String", # Required. The root path of the Cloud Storage bucket to export the metadata to, in the format gs://{bucket}/. You can optionally specify a custom prefix after the bucket name, in the format gs://{bucket}/{prefix}/. The maximum length of the custom prefix is 128 characters. Dataplex constructs the object path for the exported files by using the bucket name and prefix that you provide, followed by a system-generated path.The bucket must be in the same VPC Service Controls perimeter as the job.
+    "outputPath": "A String", # Required. The root path of the Cloud Storage bucket to export the metadata to, in the format gs://{bucket}/. You can optionally specify a custom prefix after the bucket name, in the format gs://{bucket}/{prefix}/. The maximum length of the custom prefix is 128 characters. Dataplex Universal Catalog constructs the object path for the exported files by using the bucket name and prefix that you provide, followed by a system-generated path.The bucket must be in the same VPC Service Controls perimeter as the job.
     "scope": { # The scope of the export job. # Required. The scope of the export job.
       "aspectTypes": [ # The aspect types that are in scope for the export job, specified as relative resource names in the format projects/{project_id_or_number}/locations/{location}/aspectTypes/{aspect_type_id}. Only aspects that belong to the specified aspect types are affected by the job.
         "A String",
@@ -358,7 +358,7 @@ 
Method Details

         "exportedEntries": "A String", # Output only. The number of entries that were exported.
       },
       "exportSpec": { # Job specification for a metadata export job. # Export job specification.
-        "outputPath": "A String", # Required. The root path of the Cloud Storage bucket to export the metadata to, in the format gs://{bucket}/. You can optionally specify a custom prefix after the bucket name, in the format gs://{bucket}/{prefix}/. The maximum length of the custom prefix is 128 characters. Dataplex constructs the object path for the exported files by using the bucket name and prefix that you provide, followed by a system-generated path.The bucket must be in the same VPC Service Controls perimeter as the job.
+        "outputPath": "A String", # Required. The root path of the Cloud Storage bucket to export the metadata to, in the format gs://{bucket}/. You can optionally specify a custom prefix after the bucket name, in the format gs://{bucket}/{prefix}/. The maximum length of the custom prefix is 128 characters. Dataplex Universal Catalog constructs the object path for the exported files by using the bucket name and prefix that you provide, followed by a system-generated path.The bucket must be in the same VPC Service Controls perimeter as the job.
         "scope": { # The scope of the export job. # Required. The scope of the export job.
           "aspectTypes": [ # The aspect types that are in scope for the export job, specified as relative resource names in the format projects/{project_id_or_number}/locations/{location}/aspectTypes/{aspect_type_id}. Only aspects that belong to the specified aspect types are affected by the job.
             "A String",
diff --git a/docs/dyn/digitalassetlinks_v1.assetlinks.html b/docs/dyn/digitalassetlinks_v1.assetlinks.html
index c9c2ffd7c57..98003040c79 100644
--- a/docs/dyn/digitalassetlinks_v1.assetlinks.html
+++ b/docs/dyn/digitalassetlinks_v1.assetlinks.html
@@ -159,7 +159,7 @@ 
Method Details

   "checkResults": [ # List of results for each check request. Results are returned in the same order in which they were sent in the request.
     { # Response message for the CheckAssetLinks call.
       "debugString": "A String", # Human-readable message containing information intended to help end users understand, reproduce and debug the result. The message will be in English and we are currently not planning to offer any translations. Please note that no guarantees are made about the contents or format of this string. Any aspect of it may be subject to change without notice. You should not attempt to programmatically parse this data. For programmatic access, use the error_code field below.
-      "errorCode": [ # Error codes that describe the result of the Check operation.
+      "errorCode": [ # Error codes that describe the result of the Check operation. NOTE: Error codes may be populated even when `linked` is true. The error codes do not necessarily imply that the request failed, but rather, specify any errors encountered in the statements file(s) which may or may not impact whether the server determines the requested source and target to be linked.
         "A String",
       ],
       "linked": True or False, # Set to true if the assets specified in the request are linked by the relation specified in the request.
@@ -197,7 +197,7 @@ 
Method Details

 
     { # Response message for the CheckAssetLinks call.
   "debugString": "A String", # Human-readable message containing information intended to help end users understand, reproduce and debug the result. The message will be in English and we are currently not planning to offer any translations. Please note that no guarantees are made about the contents or format of this string. Any aspect of it may be subject to change without notice. You should not attempt to programmatically parse this data. For programmatic access, use the error_code field below.
-  "errorCode": [ # Error codes that describe the result of the Check operation.
+  "errorCode": [ # Error codes that describe the result of the Check operation. NOTE: Error codes may be populated even when `linked` is true. The error codes do not necessarily imply that the request failed, but rather, specify any errors encountered in the statements file(s) which may or may not impact whether the server determines the requested source and target to be linked.
     "A String",
   ],
   "linked": True or False, # Set to true if the assets specified in the request are linked by the relation specified in the request.
diff --git a/docs/dyn/drivelabels_v2.labels.html b/docs/dyn/drivelabels_v2.labels.html
index 0e4f16b037a..dc3a0edfec8 100644
--- a/docs/dyn/drivelabels_v2.labels.html
+++ b/docs/dyn/drivelabels_v2.labels.html
@@ -94,40 +94,40 @@ 
Instance Methods

 
Close httplib2 connections.

 

   create(body=None, languageCode=None, useAdminAccess=None, x__xgafv=None)

-
Creates a new Label.

+
Creates a label. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label).

 

   delete(name, useAdminAccess=None, writeControl_requiredRevisionId=None, x__xgafv=None)

-
Permanently deletes a Label and related metadata on Drive Items. Once deleted, the Label and related Drive item metadata will be deleted. Only draft Labels, and disabled Labels may be deleted.

+
Permanently deletes a label and related metadata on Drive items. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Once deleted, the label and related Drive item metadata will be deleted. Only draft labels and disabled labels may be deleted.

 

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

-
Updates a single Label by applying a set of update requests resulting in a new draft revision. The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive Items.

+
Updates a single label by applying a set of update requests resulting in a new draft revision. For more information, see [Update a label](https://developers.google.com/workspace/drive/labels/guides/update-label). The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive items.

 

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

-
Disable a published Label. Disabling a Label will result in a new disabled published revision based on the current published revision. If there is a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.

+
Disable a published label. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Disabling a label will result in a new disabled published revision based on the current published revision. If there's a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.

 

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

-
Enable a disabled Label and restore it to its published state. This will result in a new published revision based on the current disabled published revision. If there is an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.

+
Enable a disabled label and restore it to its published state. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). This will result in a new published revision based on the current disabled published revision. If there's an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.

 

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

-
Get a label by its resource name. Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.

+
Get a label by its resource name. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label). Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.

 

   list(customer=None, languageCode=None, minimumRole=None, pageSize=None, pageToken=None, publishedOnly=None, useAdminAccess=None, view=None, x__xgafv=None)

-
List labels.

+
List labels. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label).

 

   list_next()

 
Retrieves the next page of results.

 

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

-
Publish all draft changes to the Label. Once published, the Label may not return to its draft state. See `google.apps.drive.labels.v2.Lifecycle` for more information. Publishing a Label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the Label will be rejected. For example, the following changes to a Label will be rejected after the Label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * Field.FieldType cannot be changed. * Changes to Field validation options cannot reject something that was previously accepted. * Reducing the max entries.

+
Publish all draft changes to the label. Once published, the label may not return to its draft state. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label). Publishing a label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label will be rejected. For example, the following changes to a label will be rejected after the label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * `Field.FieldType` cannot be changed. * Changes to field validation options cannot reject something that was previously accepted. * Reducing the maximum entries.

 

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

-
Updates a Label's `CopyMode`. Changes to this policy are not revisioned, do not require publishing, and take effect immediately.

+
Updates a label's `CopyMode`. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately.

 

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

-
Updates a Label's EabledAppSettings. Enabling a Label in a Workspace Application allows it to be used in that application. This change is not revisioned, does not require publishing, and takes effect immediately.

+
Updates a label's `EnabledAppSettings`. Enabling a label in a Google Workspace app allows it to be used in that app. This change isn't revisioned, doesn't require publishing, and takes effect immediately.

 

   updatePermissions(parent, body=None, useAdminAccess=None, x__xgafv=None)

-
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 
Method Details

 

     close()
@@ -136,7 +136,7 @@ 
Method Details

 
 

     create(body=None, languageCode=None, useAdminAccess=None, x__xgafv=None)
-  
Creates a new Label.
+  
Creates a label. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label).
 
 Args:
   body: object, The request body.
@@ -153,23 +153,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -182,7 +182,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -200,7 +200,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -208,12 +208,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -221,8 +221,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -230,7 +230,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -249,11 +249,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -302,7 +302,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -310,8 +310,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -329,7 +329,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -339,7 +339,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -353,7 +353,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -362,10 +362,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -373,23 +373,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -398,7 +398,7 @@ 
Method Details

   },
 }
 
-  languageCode: string, The BCP-47 language code to use for evaluating localized Field labels in response. When not specified, values in the default configured language will be used.
+  languageCode: string, The BCP-47 language code to use for evaluating localized field labels in response. When not specified, values in the default configured language will be used.
   useAdminAccess: boolean, Set to `true` in order to use the user's admin privileges. The server will verify the user is an admin before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
@@ -419,23 +419,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -448,7 +448,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -466,7 +466,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -474,12 +474,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -487,8 +487,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -496,7 +496,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -515,11 +515,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -568,7 +568,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -576,8 +576,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -595,7 +595,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -605,7 +605,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -619,7 +619,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -628,10 +628,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -639,23 +639,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -667,12 +667,12 @@ 
Method Details

 
 

     delete(name, useAdminAccess=None, writeControl_requiredRevisionId=None, x__xgafv=None)
-  
Permanently deletes a Label and related metadata on Drive Items. Once deleted, the Label and related Drive item metadata will be deleted. Only draft Labels, and disabled Labels may be deleted.
+  
Permanently deletes a label and related metadata on Drive items. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Once deleted, the label and related Drive item metadata will be deleted. Only draft labels and disabled labels may be deleted.
 
 Args:
   name: string, Required. Label resource name. (required)
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
-  writeControl_requiredRevisionId: string, The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
+  writeControl_requiredRevisionId: string, The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -687,18 +687,18 @@ 
Method Details

 
 

     delta(name, body=None, x__xgafv=None)
-  
Updates a single Label by applying a set of update requests resulting in a new draft revision. The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive Items.
+  
Updates a single label by applying a set of update requests resulting in a new draft revision. For more information, see [Update a label](https://developers.google.com/workspace/drive/labels/guides/update-label). The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive items.
 
 Args:
-  name: string, Required. The resource name of the Label to update. (required)
+  name: string, Required. The resource name of the label to update. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # The set of requests for updating aspects of a Label. If any request is not valid, no requests will be applied.
-  "languageCode": "A String", # The BCP-47 language code to use for evaluating localized Field labels when `include_label_in_response` is `true`.
-  "requests": [ # A list of updates to apply to the Label. Requests will be applied in the order they are specified.
-    { # A single kind of update to apply to a Label.
-      "createField": { # Request to create a Field within a Label. # Creates a new Field.
+{ # The set of requests for updating aspects of a label. If any request isn't valid, no requests will be applied.
+  "languageCode": "A String", # The BCP-47 language code to use for evaluating localized field labels when `include_label_in_response` is `true`.
+  "requests": [ # A list of updates to apply to the label. Requests will be applied in the order they are specified.
+    { # A single kind of update to apply to a label.
+      "createField": { # Request to create a field within a label. # Creates a field.
         "field": { # Defines a field that has a display name, data type, and other configuration options. This field defines the kind of metadata that may be set on a Drive item. # Required. Field to create.
           "appliedCapabilities": { # The capabilities related to this field on applied metadata. # Output only. The capabilities this user has on this field and its value when the label is applied on Drive items.
             "canRead": True or False, # Whether the user can read related applied metadata on items.
@@ -707,7 +707,7 @@ 
Method Details

           },
           "createTime": "A String", # Output only. The time this field was created.
           "creator": { # Information about a user. # Output only. The user who created this field.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "dateOptions": { # Options for the date field type. # Date field options.
             "dateFormat": "A String", # Output only. ICU date format.
@@ -725,7 +725,7 @@ 
Method Details

           },
           "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
           "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
             "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -733,12 +733,12 @@ 
Method Details

             "required": True or False, # Whether the field should be shown as required in the UI.
             "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
           },
-          "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+          "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
           "integerOptions": { # Options for the Integer field type. # Integer field options.
             "maxValue": "A String", # Output only. The maximum valid value for the integer field.
             "minValue": "A String", # Output only. The minimum valid value for the integer field.
           },
-          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
             "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
               "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
               "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -746,8 +746,8 @@ 
Method Details

             "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
             "state": "A String", # Output only. The state of the object associated with this lifecycle.
           },
-          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
           },
           "properties": { # The basic properties of the field. # The basic properties of the field.
             "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -755,7 +755,7 @@ 
Method Details

             "required": True or False, # Whether the field should be marked as required.
           },
           "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
           "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -774,11 +774,11 @@ 
Method Details

                 },
                 "createTime": "A String", # Output only. The time this choice was created.
                 "creator": { # Information about a user. # Output only. The user who created this choice.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
                 "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
                   "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -827,7 +827,7 @@ 
Method Details

                   "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
                 },
                 "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-                "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+                "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
                   "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                     "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                     "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -835,8 +835,8 @@ 
Method Details

                   "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
                   "state": "A String", # Output only. The state of the object associated with this lifecycle.
                 },
-                "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-                  "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+                "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+                  "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
                 },
                 "properties": { # Basic properties of the choice. # Basic properties of the choice.
                   "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -854,7 +854,7 @@ 
Method Details

                 },
                 "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
                 "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
                   "canDelete": True or False, # Whether the user can delete this choice.
@@ -864,7 +864,7 @@ 
Method Details

                 },
                 "updateTime": "A String", # Output only. The time this choice was updated last.
                 "updater": { # Information about a user. # Output only. The user who updated this choice last.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
               },
             ],
@@ -878,7 +878,7 @@ 
Method Details

           },
           "updateTime": "A String", # Output only. The time this field was updated.
           "updater": { # Information about a user. # Output only. The user who modified this field.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "userOptions": { # Options for the user field type. # User field options.
             "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -887,8 +887,8 @@ 
Method Details

           },
         },
       },
-      "createSelectionChoice": { # Request to create a Selection Choice. # Creates Choice within a Selection field.
-        "choice": { # Selection field choice. # Required. The Choice to create.
+      "createSelectionChoice": { # Request to create a selection choice. # Create a choice within a selection field.
+        "choice": { # Selection field choice. # Required. The choice to create.
           "appliedCapabilities": { # The capabilities related to this choice on applied metadata. # Output only. The capabilities related to this choice on applied metadata.
             "canRead": True or False, # Whether the user can read related applied metadata on items.
             "canSearch": True or False, # Whether the user can use this choice in search queries.
@@ -896,11 +896,11 @@ 
Method Details

           },
           "createTime": "A String", # Output only. The time this choice was created.
           "creator": { # Information about a user. # Output only. The user who created this choice.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
           "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
             "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -949,7 +949,7 @@ 
Method Details

             "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
           },
           "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
             "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
               "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
               "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -957,8 +957,8 @@ 
Method Details

             "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
             "state": "A String", # Output only. The state of the object associated with this lifecycle.
           },
-          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
           },
           "properties": { # Basic properties of the choice. # Basic properties of the choice.
             "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -976,7 +976,7 @@ 
Method Details

           },
           "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
           "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
             "canDelete": True or False, # Whether the user can delete this choice.
@@ -986,52 +986,52 @@ 
Method Details

           },
           "updateTime": "A String", # Output only. The time this choice was updated last.
           "updater": { # Information about a user. # Output only. The user who updated this choice last.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
         },
-        "fieldId": "A String", # Required. The Selection Field in which a Choice will be created.
+        "fieldId": "A String", # Required. The selection field in which a choice will be created.
       },
-      "deleteField": { # Request to delete the Field. # Deletes a Field from the label.
-        "id": "A String", # Required. ID of the Field to delete.
+      "deleteField": { # Request to delete the field. # Deletes a field from the label.
+        "id": "A String", # Required. ID of the field to delete.
       },
-      "deleteSelectionChoice": { # Request to delete a Choice. # Delete a Choice within a Selection Field.
-        "fieldId": "A String", # Required. The Selection Field from which a Choice will be deleted.
+      "deleteSelectionChoice": { # Request to delete a choice. # Delete a choice within a selection field.
+        "fieldId": "A String", # Required. The selection field from which a choice will be deleted.
         "id": "A String", # Required. Choice to delete.
       },
-      "disableField": { # Request to disable the Field. # Disables the Field.
-        "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # Required. Field Disabled Policy.
+      "disableField": { # Request to disable the field. # Disables the field.
+        "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # Required. Field disabled policy.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
         },
-        "id": "A String", # Required. Key of the Field to disable.
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "id": "A String", # Required. Key of the field to disable.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
       },
-      "disableSelectionChoice": { # Request to disable a Choice. # Disable a Choice within a Selection Field.
+      "disableSelectionChoice": { # Request to disable a choice. # Disable a choice within a selection field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # Required. The disabled policy to update.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
         },
-        "fieldId": "A String", # Required. The Selection Field in which a Choice will be disabled.
+        "fieldId": "A String", # Required. The selection field in which a choice will be disabled.
         "id": "A String", # Required. Choice to disable.
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
       },
-      "enableField": { # Request to enable the Field. # Enables the Field.
-        "id": "A String", # Required. ID of the Field to enable.
+      "enableField": { # Request to enable the field. # Enables the field.
+        "id": "A String", # Required. ID of the field to enable.
       },
-      "enableSelectionChoice": { # Request to enable a Choice. # Enable a Choice within a Selection Field.
-        "fieldId": "A String", # Required. The Selection Field in which a Choice will be enabled.
+      "enableSelectionChoice": { # Request to enable a choice. # Enable a choice within a selection field.
+        "fieldId": "A String", # Required. The selection field in which a choice will be enabled.
         "id": "A String", # Required. Choice to enable.
       },
-      "updateField": { # Request to update Field properties. # Updates basic properties of a Field.
-        "id": "A String", # Required. The Field to update.
-        "properties": { # The basic properties of the field. # Required. Basic Field properties.
+      "updateField": { # Request to update field properties. # Updates basic properties of a field.
+        "id": "A String", # Required. The field to update.
+        "properties": { # The basic properties of the field. # Required. Basic field properties.
           "displayName": "A String", # Required. The display text to show in the UI identifying this field.
           "insertBeforeField": "A String", # Input only. Insert or move this field before the indicated field. If empty, the field is placed at the end of the list.
           "required": True or False, # Whether the field should be marked as required.
         },
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
       },
-      "updateFieldType": { # Request to change the type of a Field. # Update Field type and/or type options.
+      "updateFieldType": { # Request to change the type of a field. # Update field type and/or type options.
         "dateOptions": { # Options for the date field type. # Update field to Date.
           "dateFormat": "A String", # Output only. ICU date format.
           "dateFormatType": "A String", # Localized date formatting option. Field values are rendered in this format according to their locale.
@@ -1046,7 +1046,7 @@ 
Method Details

             "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
           },
         },
-        "id": "A String", # Required. The Field to update.
+        "id": "A String", # Required. The field to update.
         "integerOptions": { # Options for the Integer field type. # Update field to Integer.
           "maxValue": "A String", # Output only. The maximum valid value for the integer field.
           "minValue": "A String", # Output only. The minimum valid value for the integer field.
@@ -1061,11 +1061,11 @@ 
Method Details

               },
               "createTime": "A String", # Output only. The time this choice was created.
               "creator": { # Information about a user. # Output only. The user who created this choice.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
               "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
                 "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -1114,7 +1114,7 @@ 
Method Details

                 "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
               },
               "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-              "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+              "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
                 "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                   "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                   "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1122,8 +1122,8 @@ 
Method Details

                 "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
                 "state": "A String", # Output only. The state of the object associated with this lifecycle.
               },
-              "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-                "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+              "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+                "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
               },
               "properties": { # Basic properties of the choice. # Basic properties of the choice.
                 "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -1141,7 +1141,7 @@ 
Method Details

               },
               "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
               "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
                 "canDelete": True or False, # Whether the user can delete this choice.
@@ -1151,7 +1151,7 @@ 
Method Details

               },
               "updateTime": "A String", # Output only. The time this choice was updated last.
               "updater": { # Information about a user. # Output only. The user who updated this choice last.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
             },
           ],
@@ -1163,24 +1163,24 @@ 
Method Details

           "maxLength": 42, # Output only. The maximum valid length of values for the text field.
           "minLength": 42, # Output only. The minimum valid length of values for the text field.
         },
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root of `type_options` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root of `type_options` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
         "userOptions": { # Options for the user field type. # Update field to User.
           "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
             "maxEntries": 42, # Maximum number of entries permitted.
           },
         },
       },
-      "updateLabel": { # Updates basic properties of a Label. # Updates the Label properties.
+      "updateLabel": { # Updates basic properties of a label. # Updates the label properties.
         "properties": { # Basic properties of the label. # Required. Label properties to update.
           "description": "A String", # The description of the label.
           "title": "A String", # Required. Title of the label.
         },
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `label_properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `label_properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
       },
-      "updateSelectionChoiceProperties": { # Request to update a Choice properties. # Update a Choice properties within a Selection Field.
-        "fieldId": "A String", # Required. The Selection Field to update.
-        "id": "A String", # Required. The Choice to update.
-        "properties": { # Basic properties of the choice. # Required. The Choice properties to update.
+      "updateSelectionChoiceProperties": { # Request to update a choice property. # Update a choice property within a selection field.
+        "fieldId": "A String", # Required. The selection field to update.
+        "id": "A String", # Required. The choice to update.
+        "properties": { # Basic properties of the choice. # Required. The choice properties to update.
           "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
             "color": { # Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha <= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red << 16) | (green << 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i < missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ... # The color of the badge. When not specified, no badge is rendered. The background, foreground, and solo (light and dark mode) colors set here are changed in the Drive UI into the closest recommended supported color.
               "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is, the final pixel color is defined by the equation: `pixel color = alpha * (this color) + (1.0 - alpha) * (background color)` This means that a value of 1.0 corresponds to a solid color, whereas a value of 0.0 corresponds to a completely transparent color. This uses a wrapper message rather than a simple float scalar so that it is possible to distinguish between a default value and the value being unset. If omitted, this color object is rendered as a solid color (as if the alpha value had been explicitly given a value of 1.0).
@@ -1194,14 +1194,14 @@ 
Method Details

           "displayName": "A String", # Required. The display text to show in the UI identifying this field.
           "insertBeforeChoice": "A String", # Input only. Insert or move this choice before the indicated choice. If empty, the choice is placed at the end of the list.
         },
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
       },
     },
   ],
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   "view": "A String", # When specified, only certain fields belonging to the indicated view will be returned.
   "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed.
-    "requiredRevisionId": "A String", # The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
+    "requiredRevisionId": "A String", # The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
   },
 }
 
@@ -1213,42 +1213,42 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for Label update.
+    { # Response for label update.
   "responses": [ # The reply of the updates. This maps 1:1 with the updates, although responses to some requests may be empty.
     { # A single response from an update.
-      "createField": { # Response following Field create. # Creates a new Field.
+      "createField": { # Response following field create. # Creates a field.
         "id": "A String", # The field of the created field. When left blank in a create request, a key will be autogenerated and can be identified here.
         "priority": 42, # The priority of the created field. The priority may change from what was specified to assure contiguous priorities between fields (1-n).
       },
-      "createSelectionChoice": { # Response following Selection Choice create. # Creates a new selection list option to add to a Selection Field.
-        "fieldId": "A String", # The server-generated id of the field.
-        "id": "A String", # The server-generated ID of the created choice within the Field
+      "createSelectionChoice": { # Response following selection choice create. # Creates a selection list option to add to a selection field.
+        "fieldId": "A String", # The server-generated ID of the field.
+        "id": "A String", # The server-generated ID of the created choice within the field.
       },
-      "deleteField": { # Response following Field delete. # Deletes a Field from the label.
+      "deleteField": { # Response following field delete. # Deletes a field from the label.
       },
-      "deleteSelectionChoice": { # Response following Choice delete. # Deletes a Choice from a Selection Field.
+      "deleteSelectionChoice": { # Response following choice delete. # Deletes a choice from a selection field.
       },
-      "disableField": { # Response following Field disable. # Disables Field.
+      "disableField": { # Response following field disable. # Disables field.
       },
-      "disableSelectionChoice": { # Response following Choice disable. # Disables a Choice within a Selection Field.
+      "disableSelectionChoice": { # Response following choice disable. # Disables a choice within a selection field.
       },
-      "enableField": { # Response following Field enable. # Enables Field.
+      "enableField": { # Response following field enable. # Enables field.
       },
-      "enableSelectionChoice": { # Response following Choice enable. # Enables a Choice within a Selection Field.
+      "enableSelectionChoice": { # Response following choice enable. # Enables a choice within a selection field.
       },
-      "updateField": { # Response following update to Field properties. # Updates basic properties of a Field.
+      "updateField": { # Response following update to field properties. # Updates basic properties of a field.
         "priority": 42, # The priority of the updated field. The priority may change from what was specified to assure contiguous priorities between fields (1-n).
       },
-      "updateFieldType": { # Response following update to Field type. # Update Field type and/or type options.
+      "updateFieldType": { # Response following update to field type. # Updates field type and/or type options.
       },
-      "updateLabel": { # Response following update to Label properties. # Updated basic properties of a Label.
+      "updateLabel": { # Response following update to label properties. # Updates basic properties of a label.
       },
-      "updateSelectionChoiceProperties": { # Response following update to Selection Choice properties. # Updates a Choice within a Selection Field.
+      "updateSelectionChoiceProperties": { # Response following update to selection choice properties. # Updates a choice within a selection field.
         "priority": 42, # The priority of the updated choice. The priority may change from what was specified to assure contiguous priorities between choices (1-n).
       },
     },
   ],
-  "updatedLabel": { # A label defines a taxonomy that can be applied to Drive items in order to organize and search across items. Labels can be simple strings, or can contain fields that describe additional metadata that can be further used to organize and search Drive items. # The label after updates were applied. This is only set if [BatchUpdateLabelResponse2.include_label_in_response] is `true` and there were no errors.
+  "updatedLabel": { # A label defines a taxonomy that can be applied to Drive items in order to organize and search across items. Labels can be simple strings, or can contain fields that describe additional metadata that can be further used to organize and search Drive items. # The label after updates were applied. This is only set if `include_label_in_response` is `true` and there were no errors.
     "appliedCapabilities": { # The capabilities a user has on this label's applied metadata. # Output only. The capabilities related to this label on applied metadata.
       "canApply": True or False, # Whether the user can apply this label to items.
       "canRead": True or False, # Whether the user can read applied metadata related to this label.
@@ -1259,23 +1259,23 @@ 
Method Details

     },
     "createTime": "A String", # Output only. The time this label was created.
     "creator": { # Information about a user. # Output only. The user who created this label.
-      "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
     },
-    "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-    "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-    "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-      "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+    "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+    "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+      "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
     },
-    "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+    "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
       "disabled": True or False, # Whether the label should be shown in the UI as disabled.
       "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-      "priority": "A String", # Order to display label in a list.
+      "priority": "A String", # The order to display labels in a list.
       "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
     },
-    "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-      "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-        { # An App where the Label can be used.
-          "app": "A String", # Optional. The name of the App.
+    "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+      "enabledApps": [ # Optional. The list of apps where the label can be used.
+        { # An app where the label can be used.
+          "app": "A String", # Optional. The name of the app.
         },
       ],
     },
@@ -1288,7 +1288,7 @@ 
Method Details

         },
         "createTime": "A String", # Output only. The time this field was created.
         "creator": { # Information about a user. # Output only. The user who created this field.
-          "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+          "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
         },
         "dateOptions": { # Options for the date field type. # Date field options.
           "dateFormat": "A String", # Output only. ICU date format.
@@ -1306,7 +1306,7 @@ 
Method Details

         },
         "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
         "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-          "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+          "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
         },
         "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
           "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -1314,12 +1314,12 @@ 
Method Details

           "required": True or False, # Whether the field should be shown as required in the UI.
           "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
         },
-        "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+        "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
         "integerOptions": { # Options for the Integer field type. # Integer field options.
           "maxValue": "A String", # Output only. The maximum valid value for the integer field.
           "minValue": "A String", # Output only. The minimum valid value for the integer field.
         },
-        "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+        "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
           "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
             "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
             "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1327,8 +1327,8 @@ 
Method Details

           "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
           "state": "A String", # Output only. The state of the object associated with this lifecycle.
         },
-        "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-          "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+        "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+          "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
         },
         "properties": { # The basic properties of the field. # The basic properties of the field.
           "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -1336,7 +1336,7 @@ 
Method Details

           "required": True or False, # Whether the field should be marked as required.
         },
         "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-          "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+          "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
         },
         "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
         "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -1355,11 +1355,11 @@ 
Method Details

               },
               "createTime": "A String", # Output only. The time this choice was created.
               "creator": { # Information about a user. # Output only. The user who created this choice.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
               "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
                 "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -1408,7 +1408,7 @@ 
Method Details

                 "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
               },
               "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-              "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+              "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
                 "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                   "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                   "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1416,8 +1416,8 @@ 
Method Details

                 "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
                 "state": "A String", # Output only. The state of the object associated with this lifecycle.
               },
-              "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-                "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+              "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+                "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
               },
               "properties": { # Basic properties of the choice. # Basic properties of the choice.
                 "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -1435,7 +1435,7 @@ 
Method Details

               },
               "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
               "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
                 "canDelete": True or False, # Whether the user can delete this choice.
@@ -1445,7 +1445,7 @@ 
Method Details

               },
               "updateTime": "A String", # Output only. The time this choice was updated last.
               "updater": { # Information about a user. # Output only. The user who updated this choice last.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
             },
           ],
@@ -1459,7 +1459,7 @@ 
Method Details

         },
         "updateTime": "A String", # Output only. The time this field was updated.
         "updater": { # Information about a user. # Output only. The user who modified this field.
-          "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+          "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
         },
         "userOptions": { # Options for the user field type. # User field options.
           "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -1468,10 +1468,10 @@ 
Method Details

         },
       },
     ],
-    "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+    "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
     "labelType": "A String", # Required. The type of label.
     "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-    "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+    "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
       "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
         "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
         "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1479,23 +1479,23 @@ 
Method Details

       "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
       "state": "A String", # Output only. The state of the object associated with this lifecycle.
     },
-    "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-      "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+    "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+      "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
     },
     "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
     "properties": { # Basic properties of the label. # Required. The basic properties of the label.
       "description": "A String", # The description of the label.
       "title": "A String", # Required. Title of the label.
     },
-    "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-    "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-      "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+    "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+      "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
     },
     "revisionCreateTime": "A String", # Output only. The time this label revision was created.
     "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-      "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
     },
-    "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+    "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
     "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
       "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
       "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -1508,23 +1508,23 @@ 
Method Details

 
 

     disable(name, body=None, x__xgafv=None)
-  
Disable a published Label. Disabling a Label will result in a new disabled published revision based on the current published revision. If there is a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.
+  
Disable a published label. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Disabling a label will result in a new disabled published revision based on the current published revision. If there's a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.
 
 Args:
   name: string, Required. Label resource name. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Request to deprecate a published Label.
+{ # Request to deprecate a published label.
   "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # Disabled policy to use.
     "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
     "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
   },
   "languageCode": "A String", # The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.
-  "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
-  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means last write wins.
-    "requiredRevisionId": "A String", # The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
+  "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
+  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means the last write wins.
+    "requiredRevisionId": "A String", # The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
   },
 }
 
@@ -1547,23 +1547,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -1576,7 +1576,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -1594,7 +1594,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -1602,12 +1602,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1615,8 +1615,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -1624,7 +1624,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -1643,11 +1643,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -1696,7 +1696,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1704,8 +1704,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -1723,7 +1723,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -1733,7 +1733,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -1747,7 +1747,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -1756,10 +1756,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1767,23 +1767,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -1795,7 +1795,7 @@ 
Method Details

 
 

     enable(name, body=None, x__xgafv=None)
-  
Enable a disabled Label and restore it to its published state. This will result in a new published revision based on the current disabled published revision. If there is an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.
+  
Enable a disabled label and restore it to its published state. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). This will result in a new published revision based on the current disabled published revision. If there's an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.
 
 Args:
   name: string, Required. Label resource name. (required)
@@ -1804,9 +1804,9 @@ 
Method Details

 
 { # Request to enable a label.
   "languageCode": "A String", # The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
-  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means last write wins.
-    "requiredRevisionId": "A String", # The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
+  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means the last write wins.
+    "requiredRevisionId": "A String", # The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
   },
 }
 
@@ -1829,23 +1829,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -1858,7 +1858,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -1876,7 +1876,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -1884,12 +1884,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1897,8 +1897,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -1906,7 +1906,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -1925,11 +1925,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -1978,7 +1978,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1986,8 +1986,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -2005,7 +2005,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -2015,7 +2015,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -2029,7 +2029,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -2038,10 +2038,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2049,23 +2049,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -2077,7 +2077,7 @@ 
Method Details

 
 

     get(name, languageCode=None, useAdminAccess=None, view=None, x__xgafv=None)
-  
Get a label by its resource name. Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.
+  
Get a label by its resource name. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label). Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.
 
 Args:
   name: string, Required. Label resource name. May be any of: * `labels/{id}` (equivalent to labels/{id}@latest) * `labels/{id}@latest` * `labels/{id}@published` * `labels/{id}@{revision_id}` (required)
@@ -2106,23 +2106,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -2135,7 +2135,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -2153,7 +2153,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -2161,12 +2161,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2174,8 +2174,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -2183,7 +2183,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -2202,11 +2202,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -2255,7 +2255,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2263,8 +2263,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -2282,7 +2282,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -2292,7 +2292,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -2306,7 +2306,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -2315,10 +2315,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2326,23 +2326,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -2354,12 +2354,12 @@ 
Method Details

 
 

     list(customer=None, languageCode=None, minimumRole=None, pageSize=None, pageToken=None, publishedOnly=None, useAdminAccess=None, view=None, x__xgafv=None)
-  
List labels.
+  
List labels. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label).
 
 Args:
-  customer: string, The customer to scope this list request to. For example: "customers/abcd1234". If unset, will return all labels within the current customer.
+  customer: string, The customer to scope this list request to. For example: `customers/abcd1234`. If unset, will return all labels within the current customer.
   languageCode: string, The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.
-  minimumRole: string, Specifies the level of access the user must have on the returned Labels. The minimum role a user must have on a label. Defaults to `READER`.
+  minimumRole: string, Specifies the level of access the user must have on the returned labels. The minimum role a user must have on a label. Defaults to `READER`.
     Allowed values
       LABEL_ROLE_UNSPECIFIED - Unknown role.
       READER - A reader can read the label and associated metadata applied to Drive items.
@@ -2369,7 +2369,7 @@ 
Method Details

   pageSize: integer, Maximum number of labels to return per page. Default: 50. Max: 200.
   pageToken: string, The token of the page to return.
   publishedOnly: boolean, Whether to include only published labels in the results. * When `true`, only the current published label revisions are returned. Disabled labels are included. Returned label resource names reference the published revision (`labels/{id}/{revision_id}`). * When `false`, the current label revisions are returned, which might not be published. Returned label resource names don't reference a specific revision (`labels/{id}`).
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. This will return all Labels within the customer.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. This will return all labels within the customer.
   view: string, When specified, only certain fields belonging to the indicated view are returned.
     Allowed values
       LABEL_VIEW_BASIC - Implies the field mask: `name,id,revision_id,label_type,properties.*`
@@ -2382,7 +2382,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for listing Labels.
+    { # Response for listing labels.
   "labels": [ # Labels.
     { # A label defines a taxonomy that can be applied to Drive items in order to organize and search across items. Labels can be simple strings, or can contain fields that describe additional metadata that can be further used to organize and search Drive items.
       "appliedCapabilities": { # The capabilities a user has on this label's applied metadata. # Output only. The capabilities related to this label on applied metadata.
@@ -2395,23 +2395,23 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this label was created.
       "creator": { # Information about a user. # Output only. The user who created this label.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
-      "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-      "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-      "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+      "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+      "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
-      "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+      "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
         "disabled": True or False, # Whether the label should be shown in the UI as disabled.
         "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-        "priority": "A String", # Order to display label in a list.
+        "priority": "A String", # The order to display labels in a list.
         "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
       },
-      "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-        "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-          { # An App where the Label can be used.
-            "app": "A String", # Optional. The name of the App.
+      "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+        "enabledApps": [ # Optional. The list of apps where the label can be used.
+          { # An app where the label can be used.
+            "app": "A String", # Optional. The name of the app.
           },
         ],
       },
@@ -2424,7 +2424,7 @@ 
Method Details

           },
           "createTime": "A String", # Output only. The time this field was created.
           "creator": { # Information about a user. # Output only. The user who created this field.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "dateOptions": { # Options for the date field type. # Date field options.
             "dateFormat": "A String", # Output only. ICU date format.
@@ -2442,7 +2442,7 @@ 
Method Details

           },
           "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
           "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
             "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -2450,12 +2450,12 @@ 
Method Details

             "required": True or False, # Whether the field should be shown as required in the UI.
             "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
           },
-          "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+          "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
           "integerOptions": { # Options for the Integer field type. # Integer field options.
             "maxValue": "A String", # Output only. The maximum valid value for the integer field.
             "minValue": "A String", # Output only. The minimum valid value for the integer field.
           },
-          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
             "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
               "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
               "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2463,8 +2463,8 @@ 
Method Details

             "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
             "state": "A String", # Output only. The state of the object associated with this lifecycle.
           },
-          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
           },
           "properties": { # The basic properties of the field. # The basic properties of the field.
             "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -2472,7 +2472,7 @@ 
Method Details

             "required": True or False, # Whether the field should be marked as required.
           },
           "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
           "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -2491,11 +2491,11 @@ 
Method Details

                 },
                 "createTime": "A String", # Output only. The time this choice was created.
                 "creator": { # Information about a user. # Output only. The user who created this choice.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
                 "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
                   "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -2544,7 +2544,7 @@ 
Method Details

                   "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
                 },
                 "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-                "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+                "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
                   "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                     "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                     "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2552,8 +2552,8 @@ 
Method Details

                   "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
                   "state": "A String", # Output only. The state of the object associated with this lifecycle.
                 },
-                "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-                  "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+                "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+                  "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
                 },
                 "properties": { # Basic properties of the choice. # Basic properties of the choice.
                   "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -2571,7 +2571,7 @@ 
Method Details

                 },
                 "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
                 "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
                   "canDelete": True or False, # Whether the user can delete this choice.
@@ -2581,7 +2581,7 @@ 
Method Details

                 },
                 "updateTime": "A String", # Output only. The time this choice was updated last.
                 "updater": { # Information about a user. # Output only. The user who updated this choice last.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
               },
             ],
@@ -2595,7 +2595,7 @@ 
Method Details

           },
           "updateTime": "A String", # Output only. The time this field was updated.
           "updater": { # Information about a user. # Output only. The user who modified this field.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "userOptions": { # Options for the user field type. # User field options.
             "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -2604,10 +2604,10 @@ 
Method Details

           },
         },
       ],
-      "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
       "labelType": "A String", # Required. The type of label.
       "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2615,23 +2615,23 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
       "properties": { # Basic properties of the label. # Required. The basic properties of the label.
         "description": "A String", # The description of the label.
         "title": "A String", # Required. Title of the label.
       },
-      "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-      "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+      "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "revisionCreateTime": "A String", # Output only. The time this label revision was created.
       "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
-      "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+      "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
       "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
         "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
         "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -2660,7 +2660,7 @@ 
Method Details

 
 

     publish(name, body=None, x__xgafv=None)
-  
Publish all draft changes to the Label. Once published, the Label may not return to its draft state. See `google.apps.drive.labels.v2.Lifecycle` for more information. Publishing a Label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the Label will be rejected. For example, the following changes to a Label will be rejected after the Label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * Field.FieldType cannot be changed. * Changes to Field validation options cannot reject something that was previously accepted. * Reducing the max entries.
+  
Publish all draft changes to the label. Once published, the label may not return to its draft state. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label). Publishing a label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label will be rejected. For example, the following changes to a label will be rejected after the label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * `Field.FieldType` cannot be changed. * Changes to field validation options cannot reject something that was previously accepted. * Reducing the maximum entries.
 
 Args:
   name: string, Required. Label resource name. (required)
@@ -2669,9 +2669,9 @@ 
Method Details

 
 { # Request to publish a label.
   "languageCode": "A String", # The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
-  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means last write wins.
-    "requiredRevisionId": "A String", # The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
+  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means the last write wins.
+    "requiredRevisionId": "A String", # The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
   },
 }
 
@@ -2694,23 +2694,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -2723,7 +2723,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -2741,7 +2741,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -2749,12 +2749,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2762,8 +2762,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -2771,7 +2771,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -2790,11 +2790,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -2843,7 +2843,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2851,8 +2851,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -2870,7 +2870,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -2880,7 +2880,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -2894,7 +2894,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -2903,10 +2903,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2914,23 +2914,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -2942,17 +2942,17 @@ 
Method Details

 
 

     updateLabelCopyMode(name, body=None, x__xgafv=None)
-  
Updates a Label's `CopyMode`. Changes to this policy are not revisioned, do not require publishing, and take effect immediately.
+  
Updates a label's `CopyMode`. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately.
 
 Args:
-  name: string, Required. The resource name of the Label to update. (required)
+  name: string, Required. The resource name of the label to update. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Request to update the `CopyMode` of the given Label. Changes to this policy are not revisioned, do not require publishing, and take effect immediately. \
-  "copyMode": "A String", # Required. Indicates how the applied Label, and Field values should be copied when a Drive item is copied.
+{ # Request to update the `CopyMode` of the given label. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately. \
+  "copyMode": "A String", # Required. Indicates how the applied label and field values should be copied when a Drive item is copied.
   "languageCode": "A String", # The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   "view": "A String", # When specified, only certain fields belonging to the indicated view will be returned.
 }
 
@@ -2975,23 +2975,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -3004,7 +3004,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -3022,7 +3022,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -3030,12 +3030,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3043,8 +3043,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -3052,7 +3052,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -3071,11 +3071,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -3124,7 +3124,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3132,8 +3132,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -3151,7 +3151,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -3161,7 +3161,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -3175,7 +3175,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -3184,10 +3184,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3195,23 +3195,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -3223,23 +3223,23 @@ 
Method Details

 
 

     updateLabelEnabledAppSettings(name, body=None, x__xgafv=None)
-  
Updates a Label's EabledAppSettings. Enabling a Label in a Workspace Application allows it to be used in that application. This change is not revisioned, does not require publishing, and takes effect immediately.
+  
Updates a label's `EnabledAppSettings`. Enabling a label in a Google Workspace app allows it to be used in that app. This change isn't revisioned, doesn't require publishing, and takes effect immediately.
 
 Args:
-  name: string, Required. The resource name of the Label to update. The resource name of the Label to update. (required)
+  name: string, Required. The resource name of the label to update. The resource name of the label to update. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Request to update the `EnabledAppSettings` of the given Label. This change is not revisioned, does not require publishing, and takes effect immediately. \
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Required. The new `EnabledAppSettings` value for the Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+{ # Request to update the `EnabledAppSettings` of the given label. This change is not revisioned, doesn't require publishing, and takes effect immediately. \
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Required. The new `EnabledAppSettings` value for the label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
   "languageCode": "A String", # Optional. The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.
-  "useAdminAccess": True or False, # Optional. Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  "useAdminAccess": True or False, # Optional. Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   "view": "A String", # Optional. When specified, only certain fields belonging to the indicated view will be returned.
 }
 
@@ -3262,23 +3262,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -3291,7 +3291,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -3309,7 +3309,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -3317,12 +3317,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3330,8 +3330,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -3339,7 +3339,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -3358,11 +3358,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -3411,7 +3411,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3419,8 +3419,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -3438,7 +3438,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -3448,7 +3448,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -3462,7 +3462,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -3471,10 +3471,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3482,23 +3482,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -3510,23 +3510,23 @@ 
Method Details

 
 

     updatePermissions(parent, body=None, useAdminAccess=None, x__xgafv=None)
-  
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name. (required)
+  parent: string, Required. The parent label resource name. (required)
   body: object, The request body.
     The object takes the form of:
 
 { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
   "role": "A String", # The role the principal should have.
 }
 
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -3536,8 +3536,8 @@ 
Method Details

   An object of the form:
 
     { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
diff --git a/docs/dyn/drivelabels_v2.labels.locks.html b/docs/dyn/drivelabels_v2.labels.locks.html
index 1fede4a2033..e7b0847899d 100644
--- a/docs/dyn/drivelabels_v2.labels.locks.html
+++ b/docs/dyn/drivelabels_v2.labels.locks.html
@@ -79,7 +79,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

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

-
Lists the LabelLocks on a Label.

+
Lists the label locks on a label.

 

   list_next()

 
Retrieves the next page of results.

@@ -91,11 +91,11 @@ 
Method Details

 
 

     list(parent, pageSize=None, pageToken=None, x__xgafv=None)
-  
Lists the LabelLocks on a Label.
+  
Lists the label locks on a label.
 
 Args:
-  parent: string, Required. Label on which Locks are applied. Format: labels/{label} (required)
-  pageSize: integer, Maximum number of Locks to return per page. Default: 100. Max: 200.
+  parent: string, Required. Label on which locks are applied. Format: `labels/{label}`. (required)
+  pageSize: integer, Maximum number of locks to return per page. Default: 100. Max: 200.
   pageToken: string, The token of the page to return.
   x__xgafv: string, V1 error format.
     Allowed values
@@ -105,21 +105,21 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # The response to a ListLabelLocksRequest.
-  "labelLocks": [ # LabelLocks.
-    { # A Lock that can be applied to a Label, Field, or Choice.
-      "capabilities": { # A description of a user's capabilities on a LabelLock. # Output only. The user's capabilities on this LabelLock.
+    { # The response to a `ListLabelLocksRequest`.
+  "labelLocks": [ # Label locks.
+    { # A lock that can be applied to a label, field, or choice.
+      "capabilities": { # A description of a user's capabilities on a label lock. # Output only. The user's capabilities on this label lock.
         "canViewPolicy": True or False, # True if the user is authorized to view the policy.
       },
-      "choiceId": "A String", # The ID of the Selection Field Choice that should be locked. If present, `field_id` must also be present.
-      "createTime": "A String", # Output only. The time this LabelLock was created.
-      "creator": { # Information about a user. # Output only. The user whose credentials were used to create the LabelLock. This will not be present if no user was responsible for creating the LabelLock.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "choiceId": "A String", # The ID of the selection field choice that should be locked. If present, `field_id` must also be present.
+      "createTime": "A String", # Output only. The time this label lock was created.
+      "creator": { # Information about a user. # Output only. The user whose credentials were used to create the label lock. Not present if no user was responsible for creating the label lock.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
-      "deleteTime": "A String", # Output only. A timestamp indicating when this LabelLock was scheduled for deletion. This will be present only if this LabelLock is in the DELETING state.
-      "fieldId": "A String", # The ID of the Field that should be locked. Empty if the whole Label should be locked.
-      "name": "A String", # Output only. Resource name of this LabelLock.
-      "state": "A String", # Output only. This LabelLock's state.
+      "deleteTime": "A String", # Output only. A timestamp indicating when this label lock was scheduled for deletion. Present only if this label lock is in the `DELETING` state.
+      "fieldId": "A String", # The ID of the field that should be locked. Empty if the whole label should be locked.
+      "name": "A String", # Output only. Resource name of this label lock.
+      "state": "A String", # Output only. This label lock's state.
     },
   ],
   "nextPageToken": "A String", # The token of the next page in the response.
diff --git a/docs/dyn/drivelabels_v2.labels.permissions.html b/docs/dyn/drivelabels_v2.labels.permissions.html
index b41b14449bd..b9783dc4442 100644
--- a/docs/dyn/drivelabels_v2.labels.permissions.html
+++ b/docs/dyn/drivelabels_v2.labels.permissions.html
@@ -76,43 +76,43 @@ 
Drive Labels API . 
   batchDelete(parent, body=None, x__xgafv=None)

-
Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

   close()

 
Close httplib2 connections.

 

   create(parent, body=None, useAdminAccess=None, x__xgafv=None)

-
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Lists a Label's permissions.

+
Lists a label's permissions.

 

   list_next()

 
Retrieves the next page of results.

 
Method Details

 

     batchDelete(parent, body=None, x__xgafv=None)
-  
Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name shared by all permissions being deleted. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field. (required)
+  parent: string, Required. The parent label resource name shared by all permissions being deleted. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Deletes one of more Label Permissions.
+{ # Deletes one or more label permissions.
   "requests": [ # Required. The request message specifying the resources to update.
-    { # Deletes a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
-      "name": "A String", # Required. Label Permission resource name.
-      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+    { # Deletes a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
+      "name": "A String", # Required. Label permission resource name.
+      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
     },
   ],
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the DeleteLabelPermissionRequest messages must either be empty or match this field.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `DeleteLabelPermissionRequest` messages must either be empty or match this field.
 }
 
   x__xgafv: string, V1 error format.
@@ -129,29 +129,29 @@ 
Method Details

 
 

     batchUpdate(parent, body=None, x__xgafv=None)
-  
Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name shared by all permissions being updated. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field. (required)
+  parent: string, Required. The parent label resource name shared by all permissions being updated. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Updates one or more Label Permissions.
+{ # Updates one or more label permissions.
   "requests": [ # Required. The request message specifying the resources to update.
-    { # Updates a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
-      "labelPermission": { # The permission that applies to a principal (user, group, audience) on a label. # Required. The permission to create or update on the Label.
-        "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-        "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+    { # Updates a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
+      "labelPermission": { # The permission that applies to a principal (user, group, audience) on a label. # Required. The permission to create or update on the label.
+        "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+        "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
         "group": "A String", # Group resource name.
         "name": "A String", # Resource name of this permission.
         "person": "A String", # Person resource name.
         "role": "A String", # The role the principal should have.
       },
-      "parent": "A String", # Required. The parent Label resource name.
-      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+      "parent": "A String", # Required. The parent label resource name.
+      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
     },
   ],
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the UpdateLabelPermissionRequest messages must either be empty or match this field.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.
 }
 
   x__xgafv: string, V1 error format.
@@ -162,11 +162,11 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for updating one or more Label Permissions.
+    { # Response for updating one or more label permissions.
   "permissions": [ # Required. Permissions updated.
     { # The permission that applies to a principal (user, group, audience) on a label.
-      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-      "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+      "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
       "group": "A String", # Group resource name.
       "name": "A String", # Resource name of this permission.
       "person": "A String", # Person resource name.
@@ -183,23 +183,23 @@ 
Method Details

 
 

     create(parent, body=None, useAdminAccess=None, x__xgafv=None)
-  
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name on the Label Permission is created. Format: labels/{label} (required)
+  parent: string, Required. The parent label resource name on the label permission is created. Format: `labels/{label}`. (required)
   body: object, The request body.
     The object takes the form of:
 
 { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
   "role": "A String", # The role the principal should have.
 }
 
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -209,8 +209,8 @@ 
Method Details

   An object of the form:
 
     { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
@@ -220,11 +220,11 @@ 
Method Details

 
 

     delete(name, useAdminAccess=None, x__xgafv=None)
-  
Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  name: string, Required. Label Permission resource name. (required)
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  name: string, Required. Label permission resource name. (required)
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -239,13 +239,13 @@ 
Method Details

 
 

     list(parent, pageSize=None, pageToken=None, useAdminAccess=None, x__xgafv=None)
-  
Lists a Label's permissions.
+  
Lists a label's permissions.
 
 Args:
-  parent: string, Required. The parent Label resource name on which Label Permission are listed. Format: labels/{label} (required)
+  parent: string, Required. The parent label resource name on which label permissions are listed. Format: `labels/{label}`. (required)
   pageSize: integer, Maximum number of permissions to return per page. Default: 50. Max: 200.
   pageToken: string, The token of the page to return.
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -254,11 +254,11 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for listing the permissions on a Label.
+    { # Response for listing the permissions on a label.
   "labelPermissions": [ # Label permissions.
     { # The permission that applies to a principal (user, group, audience) on a label.
-      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-      "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+      "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
       "group": "A String", # Group resource name.
       "name": "A String", # Resource name of this permission.
       "person": "A String", # Person resource name.
diff --git a/docs/dyn/drivelabels_v2.labels.revisions.html b/docs/dyn/drivelabels_v2.labels.revisions.html
index ce8baa81848..107a0a2798f 100644
--- a/docs/dyn/drivelabels_v2.labels.revisions.html
+++ b/docs/dyn/drivelabels_v2.labels.revisions.html
@@ -89,7 +89,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

   updatePermissions(parent, body=None, useAdminAccess=None, x__xgafv=None)

-
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 
Method Details

 

     close()
@@ -98,23 +98,23 @@ 
Method Details

 
 

     updatePermissions(parent, body=None, useAdminAccess=None, x__xgafv=None)
-  
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name. (required)
+  parent: string, Required. The parent label resource name. (required)
   body: object, The request body.
     The object takes the form of:
 
 { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
   "role": "A String", # The role the principal should have.
 }
 
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -124,8 +124,8 @@ 
Method Details

   An object of the form:
 
     { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
diff --git a/docs/dyn/drivelabels_v2.labels.revisions.locks.html b/docs/dyn/drivelabels_v2.labels.revisions.locks.html
index 309baae75df..d2dd64e48fe 100644
--- a/docs/dyn/drivelabels_v2.labels.revisions.locks.html
+++ b/docs/dyn/drivelabels_v2.labels.revisions.locks.html
@@ -79,7 +79,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

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

-
Lists the LabelLocks on a Label.

+
Lists the label locks on a label.

 

   list_next()

 
Retrieves the next page of results.

@@ -91,11 +91,11 @@ 
Method Details

 
 

     list(parent, pageSize=None, pageToken=None, x__xgafv=None)
-  
Lists the LabelLocks on a Label.
+  
Lists the label locks on a label.
 
 Args:
-  parent: string, Required. Label on which Locks are applied. Format: labels/{label} (required)
-  pageSize: integer, Maximum number of Locks to return per page. Default: 100. Max: 200.
+  parent: string, Required. Label on which locks are applied. Format: `labels/{label}`. (required)
+  pageSize: integer, Maximum number of locks to return per page. Default: 100. Max: 200.
   pageToken: string, The token of the page to return.
   x__xgafv: string, V1 error format.
     Allowed values
@@ -105,21 +105,21 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # The response to a ListLabelLocksRequest.
-  "labelLocks": [ # LabelLocks.
-    { # A Lock that can be applied to a Label, Field, or Choice.
-      "capabilities": { # A description of a user's capabilities on a LabelLock. # Output only. The user's capabilities on this LabelLock.
+    { # The response to a `ListLabelLocksRequest`.
+  "labelLocks": [ # Label locks.
+    { # A lock that can be applied to a label, field, or choice.
+      "capabilities": { # A description of a user's capabilities on a label lock. # Output only. The user's capabilities on this label lock.
         "canViewPolicy": True or False, # True if the user is authorized to view the policy.
       },
-      "choiceId": "A String", # The ID of the Selection Field Choice that should be locked. If present, `field_id` must also be present.
-      "createTime": "A String", # Output only. The time this LabelLock was created.
-      "creator": { # Information about a user. # Output only. The user whose credentials were used to create the LabelLock. This will not be present if no user was responsible for creating the LabelLock.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "choiceId": "A String", # The ID of the selection field choice that should be locked. If present, `field_id` must also be present.
+      "createTime": "A String", # Output only. The time this label lock was created.
+      "creator": { # Information about a user. # Output only. The user whose credentials were used to create the label lock. Not present if no user was responsible for creating the label lock.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
-      "deleteTime": "A String", # Output only. A timestamp indicating when this LabelLock was scheduled for deletion. This will be present only if this LabelLock is in the DELETING state.
-      "fieldId": "A String", # The ID of the Field that should be locked. Empty if the whole Label should be locked.
-      "name": "A String", # Output only. Resource name of this LabelLock.
-      "state": "A String", # Output only. This LabelLock's state.
+      "deleteTime": "A String", # Output only. A timestamp indicating when this label lock was scheduled for deletion. Present only if this label lock is in the `DELETING` state.
+      "fieldId": "A String", # The ID of the field that should be locked. Empty if the whole label should be locked.
+      "name": "A String", # Output only. Resource name of this label lock.
+      "state": "A String", # Output only. This label lock's state.
     },
   ],
   "nextPageToken": "A String", # The token of the next page in the response.
diff --git a/docs/dyn/drivelabels_v2.labels.revisions.permissions.html b/docs/dyn/drivelabels_v2.labels.revisions.permissions.html
index 76af0a08c80..ecd9435b7c4 100644
--- a/docs/dyn/drivelabels_v2.labels.revisions.permissions.html
+++ b/docs/dyn/drivelabels_v2.labels.revisions.permissions.html
@@ -76,43 +76,43 @@ 
Drive Labels API . 
   batchDelete(parent, body=None, x__xgafv=None)

-
Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

   close()

 
Close httplib2 connections.

 

   create(parent, body=None, useAdminAccess=None, x__xgafv=None)

-
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Lists a Label's permissions.

+
Lists a label's permissions.

 

   list_next()

 
Retrieves the next page of results.

 
Method Details

 

     batchDelete(parent, body=None, x__xgafv=None)
-  
Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name shared by all permissions being deleted. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field. (required)
+  parent: string, Required. The parent label resource name shared by all permissions being deleted. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Deletes one of more Label Permissions.
+{ # Deletes one or more label permissions.
   "requests": [ # Required. The request message specifying the resources to update.
-    { # Deletes a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
-      "name": "A String", # Required. Label Permission resource name.
-      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+    { # Deletes a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
+      "name": "A String", # Required. Label permission resource name.
+      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
     },
   ],
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the DeleteLabelPermissionRequest messages must either be empty or match this field.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `DeleteLabelPermissionRequest` messages must either be empty or match this field.
 }
 
   x__xgafv: string, V1 error format.
@@ -129,29 +129,29 @@ 
Method Details

 
 

     batchUpdate(parent, body=None, x__xgafv=None)
-  
Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name shared by all permissions being updated. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field. (required)
+  parent: string, Required. The parent label resource name shared by all permissions being updated. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Updates one or more Label Permissions.
+{ # Updates one or more label permissions.
   "requests": [ # Required. The request message specifying the resources to update.
-    { # Updates a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
-      "labelPermission": { # The permission that applies to a principal (user, group, audience) on a label. # Required. The permission to create or update on the Label.
-        "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-        "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+    { # Updates a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
+      "labelPermission": { # The permission that applies to a principal (user, group, audience) on a label. # Required. The permission to create or update on the label.
+        "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+        "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
         "group": "A String", # Group resource name.
         "name": "A String", # Resource name of this permission.
         "person": "A String", # Person resource name.
         "role": "A String", # The role the principal should have.
       },
-      "parent": "A String", # Required. The parent Label resource name.
-      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+      "parent": "A String", # Required. The parent label resource name.
+      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
     },
   ],
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the UpdateLabelPermissionRequest messages must either be empty or match this field.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.
 }
 
   x__xgafv: string, V1 error format.
@@ -162,11 +162,11 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for updating one or more Label Permissions.
+    { # Response for updating one or more label permissions.
   "permissions": [ # Required. Permissions updated.
     { # The permission that applies to a principal (user, group, audience) on a label.
-      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-      "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+      "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
       "group": "A String", # Group resource name.
       "name": "A String", # Resource name of this permission.
       "person": "A String", # Person resource name.
@@ -183,23 +183,23 @@ 
Method Details

 
 

     create(parent, body=None, useAdminAccess=None, x__xgafv=None)
-  
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name on the Label Permission is created. Format: labels/{label} (required)
+  parent: string, Required. The parent label resource name on the label permission is created. Format: `labels/{label}`. (required)
   body: object, The request body.
     The object takes the form of:
 
 { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
   "role": "A String", # The role the principal should have.
 }
 
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -209,8 +209,8 @@ 
Method Details

   An object of the form:
 
     { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
@@ -220,11 +220,11 @@ 
Method Details

 
 

     delete(name, useAdminAccess=None, x__xgafv=None)
-  
Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  name: string, Required. Label Permission resource name. (required)
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  name: string, Required. Label permission resource name. (required)
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -239,13 +239,13 @@ 
Method Details

 
 

     list(parent, pageSize=None, pageToken=None, useAdminAccess=None, x__xgafv=None)
-  
Lists a Label's permissions.
+  
Lists a label's permissions.
 
 Args:
-  parent: string, Required. The parent Label resource name on which Label Permission are listed. Format: labels/{label} (required)
+  parent: string, Required. The parent label resource name on which label permissions are listed. Format: `labels/{label}`. (required)
   pageSize: integer, Maximum number of permissions to return per page. Default: 50. Max: 200.
   pageToken: string, The token of the page to return.
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -254,11 +254,11 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for listing the permissions on a Label.
+    { # Response for listing the permissions on a label.
   "labelPermissions": [ # Label permissions.
     { # The permission that applies to a principal (user, group, audience) on a label.
-      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-      "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+      "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
       "group": "A String", # Group resource name.
       "name": "A String", # Resource name of this permission.
       "person": "A String", # Person resource name.
diff --git a/docs/dyn/drivelabels_v2.limits.html b/docs/dyn/drivelabels_v2.limits.html
index 46c92d8f234..f32d9582729 100644
--- a/docs/dyn/drivelabels_v2.limits.html
+++ b/docs/dyn/drivelabels_v2.limits.html
@@ -79,7 +79,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

   getLabel(name=None, x__xgafv=None)

-
Get the constraints on the structure of a Label; such as, the maximum number of Fields allowed and maximum length of the label title.

+
Get the constraints on the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.

 
Method Details

 

     close()
@@ -88,10 +88,10 @@ 
Method Details

 
 

     getLabel(name=None, x__xgafv=None)
-  
Get the constraints on the structure of a Label; such as, the maximum number of Fields allowed and maximum length of the label title.
+  
Get the constraints on the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.
 
 Args:
-  name: string, Required. Label revision resource name Must be: "limits/label"
+  name: string, Required. Label revision resource name must be: "limits/label".
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -100,54 +100,54 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Label constraints governing the structure of a Label; such as, the maximum number of Fields allowed and maximum length of the label title.
-  "fieldLimits": { # Field constants governing the structure of a Field; such as, the maximum title length, minimum and maximum field values or length, etc. # The limits for Fields.
-    "dateLimits": { # Limits for date Field type. # Date Field limits.
-      "maxValue": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Maximum value for the date Field type.
+    { # Label constraints governing the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.
+  "fieldLimits": { # Field constants governing the structure of a field; such as, the maximum title length, minimum and maximum field values or length, etc. # The limits for fields.
+    "dateLimits": { # Limits for date field type. # Date field limits.
+      "maxValue": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Maximum value for the date field type.
         "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
         "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
         "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
       },
-      "minValue": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Minimum value for the date Field type.
+      "minValue": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Minimum value for the date field type.
         "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
         "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
         "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
       },
     },
-    "integerLimits": { # Limits for integer Field type. # Integer Field limits.
-      "maxValue": "A String", # Maximum value for an integer Field type.
-      "minValue": "A String", # Minimum value for an integer Field type.
+    "integerLimits": { # Limits for integer field type. # Integer field limits.
+      "maxValue": "A String", # Maximum value for an integer field type.
+      "minValue": "A String", # Minimum value for an integer field type.
     },
-    "longTextLimits": { # Limits for long text Field type. # Long text Field limits.
-      "maxLength": 42, # Maximum length allowed for a long text Field type.
-      "minLength": 42, # Minimum length allowed for a long text Field type.
+    "longTextLimits": { # Limits for long text field type. # Long text field limits.
+      "maxLength": 42, # Maximum length allowed for a long text field type.
+      "minLength": 42, # Minimum length allowed for a long text field type.
     },
-    "maxDescriptionLength": 42, # Limits for Field description, also called help text.
-    "maxDisplayNameLength": 42, # Limits for Field title.
-    "maxIdLength": 42, # Max length for the id.
-    "selectionLimits": { # Limits for selection Field type. # Selection Field limits.
-      "listLimits": { # Limits for list-variant of a Field type. # Limits for list-variant of a Field type.
-        "maxEntries": 42, # Maximum number of values allowed for the Field type.
+    "maxDescriptionLength": 42, # Limits for field description, also called help text.
+    "maxDisplayNameLength": 42, # Limits for field title.
+    "maxIdLength": 42, # Maximum length for the id.
+    "selectionLimits": { # Limits for selection field type. # Selection field limits.
+      "listLimits": { # Limits for list-variant of a field type. # Limits for list-variant of a field type.
+        "maxEntries": 42, # Maximum number of values allowed for the field type.
       },
-      "maxChoices": 42, # The max number of choices.
+      "maxChoices": 42, # Maximum number of choices.
       "maxDeletedChoices": 42, # Maximum number of deleted choices.
       "maxDisplayNameLength": 42, # Maximum length for display name.
-      "maxIdLength": 42, # Maximum ID length for a selection options.
+      "maxIdLength": 42, # Maximum ID length for a selection option.
     },
-    "textLimits": { # Limits for text Field type. # The relevant limits for the specified Field.Type. Text Field limits.
-      "maxLength": 42, # Maximum length allowed for a text Field type.
-      "minLength": 42, # Minimum length allowed for a text Field type.
+    "textLimits": { # Limits for text field type. # The relevant limits for the specified Field.Type. Text field limits.
+      "maxLength": 42, # Maximum length allowed for a text field type.
+      "minLength": 42, # Minimum length allowed for a text field type.
     },
-    "userLimits": { # Limits for Field.Type.USER. # User Field limits.
-      "listLimits": { # Limits for list-variant of a Field type. # Limits for list-variant of a Field type.
-        "maxEntries": 42, # Maximum number of values allowed for the Field type.
+    "userLimits": { # Limits for Field.Type.USER. # User field limits.
+      "listLimits": { # Limits for list-variant of a field type. # Limits for list-variant of a field type.
+        "maxEntries": 42, # Maximum number of values allowed for the field type.
       },
     },
   },
-  "maxDeletedFields": 42, # The maximum number of published Fields that can be deleted.
+  "maxDeletedFields": 42, # The maximum number of published fields that can be deleted.
   "maxDescriptionLength": 42, # The maximum number of characters allowed for the description.
   "maxDraftRevisions": 42, # The maximum number of draft revisions that will be kept before deleting old drafts.
-  "maxFields": 42, # The maximum number of Fields allowed within the label.
+  "maxFields": 42, # The maximum number of fields allowed within the label.
   "maxTitleLength": 42, # The maximum number of characters allowed for the title.
   "name": "A String", # Resource name.
 }

diff --git a/docs/dyn/drivelabels_v2.users.html b/docs/dyn/drivelabels_v2.users.html
index e59a34dc796..d26867485c1 100644
--- a/docs/dyn/drivelabels_v2.users.html
+++ b/docs/dyn/drivelabels_v2.users.html
@@ -92,7 +92,7 @@ 
Method Details

 
 Args:
   name: string, Required. The resource name of the user. Only "users/me/capabilities" is supported. (required)
-  customer: string, The customer to scope this request to. For example: "customers/abcd1234". If unset, will return settings within the current customer.
+  customer: string, The customer to scope this request to. For example: `customers/abcd1234`. If unset, it will return settings within the current customer.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -104,8 +104,8 @@ 
Method Details

     { # The capabilities of a user.
   "canAccessLabelManager": True or False, # Output only. Whether the user is allowed access to the label manager.
   "canAdministrateLabels": True or False, # Output only. Whether the user is an administrator for the shared labels feature.
-  "canCreateAdminLabels": True or False, # Output only. Whether the user is allowed to create new admin labels.
-  "canCreateSharedLabels": True or False, # Output only. Whether the user is allowed to create new shared labels.
+  "canCreateAdminLabels": True or False, # Output only. Whether the user is allowed to create admin labels.
+  "canCreateSharedLabels": True or False, # Output only. Whether the user is allowed to create shared labels.
   "name": "A String", # Output only. Resource name for the user capabilities.
 }

 

diff --git a/docs/dyn/drivelabels_v2beta.labels.html b/docs/dyn/drivelabels_v2beta.labels.html
index f61a77945c5..64c509989fe 100644
--- a/docs/dyn/drivelabels_v2beta.labels.html
+++ b/docs/dyn/drivelabels_v2beta.labels.html
@@ -94,40 +94,40 @@ 
Instance Methods

 
Close httplib2 connections.

 

   create(body=None, languageCode=None, useAdminAccess=None, x__xgafv=None)

-
Creates a new Label.

+
Creates a label. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label).

 

   delete(name, useAdminAccess=None, writeControl_requiredRevisionId=None, x__xgafv=None)

-
Permanently deletes a Label and related metadata on Drive Items. Once deleted, the Label and related Drive item metadata will be deleted. Only draft Labels, and disabled Labels may be deleted.

+
Permanently deletes a label and related metadata on Drive items. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Once deleted, the label and related Drive item metadata will be deleted. Only draft labels and disabled labels may be deleted.

 

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

-
Updates a single Label by applying a set of update requests resulting in a new draft revision. The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive Items.

+
Updates a single label by applying a set of update requests resulting in a new draft revision. For more information, see [Update a label](https://developers.google.com/workspace/drive/labels/guides/update-label). The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive items.

 

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

-
Disable a published Label. Disabling a Label will result in a new disabled published revision based on the current published revision. If there is a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.

+
Disable a published label. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Disabling a label will result in a new disabled published revision based on the current published revision. If there's a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.

 

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

-
Enable a disabled Label and restore it to its published state. This will result in a new published revision based on the current disabled published revision. If there is an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.

+
Enable a disabled label and restore it to its published state. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). This will result in a new published revision based on the current disabled published revision. If there's an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.

 

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

-
Get a label by its resource name. Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.

+
Get a label by its resource name. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label). Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.

 

   list(customer=None, languageCode=None, minimumRole=None, pageSize=None, pageToken=None, publishedOnly=None, useAdminAccess=None, view=None, x__xgafv=None)

-
List labels.

+
List labels. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label).

 

   list_next()

 
Retrieves the next page of results.

 

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

-
Publish all draft changes to the Label. Once published, the Label may not return to its draft state. See `google.apps.drive.labels.v2.Lifecycle` for more information. Publishing a Label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the Label will be rejected. For example, the following changes to a Label will be rejected after the Label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * Field.FieldType cannot be changed. * Changes to Field validation options cannot reject something that was previously accepted. * Reducing the max entries.

+
Publish all draft changes to the label. Once published, the label may not return to its draft state. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label). Publishing a label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label will be rejected. For example, the following changes to a label will be rejected after the label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * `Field.FieldType` cannot be changed. * Changes to field validation options cannot reject something that was previously accepted. * Reducing the maximum entries.

 

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

-
Updates a Label's `CopyMode`. Changes to this policy are not revisioned, do not require publishing, and take effect immediately.

+
Updates a label's `CopyMode`. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately.

 

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

-
Updates a Label's EabledAppSettings. Enabling a Label in a Workspace Application allows it to be used in that application. This change is not revisioned, does not require publishing, and takes effect immediately.

+
Updates a label's `EnabledAppSettings`. Enabling a label in a Google Workspace app allows it to be used in that app. This change isn't revisioned, doesn't require publishing, and takes effect immediately.

 

   updatePermissions(parent, body=None, useAdminAccess=None, x__xgafv=None)

-
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 
Method Details

 

     close()
@@ -136,7 +136,7 @@ 
Method Details

 
 

     create(body=None, languageCode=None, useAdminAccess=None, x__xgafv=None)
-  
Creates a new Label.
+  
Creates a label. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label).
 
 Args:
   body: object, The request body.
@@ -153,23 +153,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -182,7 +182,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -200,7 +200,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -208,12 +208,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -221,8 +221,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -230,7 +230,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -249,11 +249,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -302,7 +302,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -310,8 +310,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -329,7 +329,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -339,7 +339,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -353,7 +353,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -362,10 +362,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -373,23 +373,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -398,7 +398,7 @@ 
Method Details

   },
 }
 
-  languageCode: string, The BCP-47 language code to use for evaluating localized Field labels in response. When not specified, values in the default configured language will be used.
+  languageCode: string, The BCP-47 language code to use for evaluating localized field labels in response. When not specified, values in the default configured language will be used.
   useAdminAccess: boolean, Set to `true` in order to use the user's admin privileges. The server will verify the user is an admin before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
@@ -419,23 +419,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -448,7 +448,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -466,7 +466,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -474,12 +474,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -487,8 +487,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -496,7 +496,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -515,11 +515,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -568,7 +568,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -576,8 +576,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -595,7 +595,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -605,7 +605,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -619,7 +619,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -628,10 +628,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -639,23 +639,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -667,12 +667,12 @@ 
Method Details

 
 

     delete(name, useAdminAccess=None, writeControl_requiredRevisionId=None, x__xgafv=None)
-  
Permanently deletes a Label and related metadata on Drive Items. Once deleted, the Label and related Drive item metadata will be deleted. Only draft Labels, and disabled Labels may be deleted.
+  
Permanently deletes a label and related metadata on Drive items. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Once deleted, the label and related Drive item metadata will be deleted. Only draft labels and disabled labels may be deleted.
 
 Args:
   name: string, Required. Label resource name. (required)
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
-  writeControl_requiredRevisionId: string, The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
+  writeControl_requiredRevisionId: string, The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -687,18 +687,18 @@ 
Method Details

 
 

     delta(name, body=None, x__xgafv=None)
-  
Updates a single Label by applying a set of update requests resulting in a new draft revision. The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive Items.
+  
Updates a single label by applying a set of update requests resulting in a new draft revision. For more information, see [Update a label](https://developers.google.com/workspace/drive/labels/guides/update-label). The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive items.
 
 Args:
-  name: string, Required. The resource name of the Label to update. (required)
+  name: string, Required. The resource name of the label to update. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # The set of requests for updating aspects of a Label. If any request is not valid, no requests will be applied.
-  "languageCode": "A String", # The BCP-47 language code to use for evaluating localized Field labels when `include_label_in_response` is `true`.
-  "requests": [ # A list of updates to apply to the Label. Requests will be applied in the order they are specified.
-    { # A single kind of update to apply to a Label.
-      "createField": { # Request to create a Field within a Label. # Creates a new Field.
+{ # The set of requests for updating aspects of a label. If any request isn't valid, no requests will be applied.
+  "languageCode": "A String", # The BCP-47 language code to use for evaluating localized field labels when `include_label_in_response` is `true`.
+  "requests": [ # A list of updates to apply to the label. Requests will be applied in the order they are specified.
+    { # A single kind of update to apply to a label.
+      "createField": { # Request to create a field within a label. # Creates a field.
         "field": { # Defines a field that has a display name, data type, and other configuration options. This field defines the kind of metadata that may be set on a Drive item. # Required. Field to create.
           "appliedCapabilities": { # The capabilities related to this field on applied metadata. # Output only. The capabilities this user has on this field and its value when the label is applied on Drive items.
             "canRead": True or False, # Whether the user can read related applied metadata on items.
@@ -707,7 +707,7 @@ 
Method Details

           },
           "createTime": "A String", # Output only. The time this field was created.
           "creator": { # Information about a user. # Output only. The user who created this field.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "dateOptions": { # Options for the date field type. # Date field options.
             "dateFormat": "A String", # Output only. ICU date format.
@@ -725,7 +725,7 @@ 
Method Details

           },
           "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
           "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
             "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -733,12 +733,12 @@ 
Method Details

             "required": True or False, # Whether the field should be shown as required in the UI.
             "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
           },
-          "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+          "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
           "integerOptions": { # Options for the Integer field type. # Integer field options.
             "maxValue": "A String", # Output only. The maximum valid value for the integer field.
             "minValue": "A String", # Output only. The minimum valid value for the integer field.
           },
-          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
             "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
               "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
               "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -746,8 +746,8 @@ 
Method Details

             "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
             "state": "A String", # Output only. The state of the object associated with this lifecycle.
           },
-          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
           },
           "properties": { # The basic properties of the field. # The basic properties of the field.
             "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -755,7 +755,7 @@ 
Method Details

             "required": True or False, # Whether the field should be marked as required.
           },
           "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
           "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -774,11 +774,11 @@ 
Method Details

                 },
                 "createTime": "A String", # Output only. The time this choice was created.
                 "creator": { # Information about a user. # Output only. The user who created this choice.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
                 "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
                   "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -827,7 +827,7 @@ 
Method Details

                   "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
                 },
                 "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-                "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+                "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
                   "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                     "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                     "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -835,8 +835,8 @@ 
Method Details

                   "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
                   "state": "A String", # Output only. The state of the object associated with this lifecycle.
                 },
-                "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-                  "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+                "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+                  "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
                 },
                 "properties": { # Basic properties of the choice. # Basic properties of the choice.
                   "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -854,7 +854,7 @@ 
Method Details

                 },
                 "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
                 "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
                   "canDelete": True or False, # Whether the user can delete this choice.
@@ -864,7 +864,7 @@ 
Method Details

                 },
                 "updateTime": "A String", # Output only. The time this choice was updated last.
                 "updater": { # Information about a user. # Output only. The user who updated this choice last.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
               },
             ],
@@ -878,7 +878,7 @@ 
Method Details

           },
           "updateTime": "A String", # Output only. The time this field was updated.
           "updater": { # Information about a user. # Output only. The user who modified this field.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "userOptions": { # Options for the user field type. # User field options.
             "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -887,8 +887,8 @@ 
Method Details

           },
         },
       },
-      "createSelectionChoice": { # Request to create a Selection Choice. # Creates Choice within a Selection field.
-        "choice": { # Selection field choice. # Required. The Choice to create.
+      "createSelectionChoice": { # Request to create a selection choice. # Create a choice within a selection field.
+        "choice": { # Selection field choice. # Required. The choice to create.
           "appliedCapabilities": { # The capabilities related to this choice on applied metadata. # Output only. The capabilities related to this choice on applied metadata.
             "canRead": True or False, # Whether the user can read related applied metadata on items.
             "canSearch": True or False, # Whether the user can use this choice in search queries.
@@ -896,11 +896,11 @@ 
Method Details

           },
           "createTime": "A String", # Output only. The time this choice was created.
           "creator": { # Information about a user. # Output only. The user who created this choice.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
           "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
             "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -949,7 +949,7 @@ 
Method Details

             "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
           },
           "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
             "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
               "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
               "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -957,8 +957,8 @@ 
Method Details

             "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
             "state": "A String", # Output only. The state of the object associated with this lifecycle.
           },
-          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
           },
           "properties": { # Basic properties of the choice. # Basic properties of the choice.
             "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -976,7 +976,7 @@ 
Method Details

           },
           "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
           "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
             "canDelete": True or False, # Whether the user can delete this choice.
@@ -986,52 +986,52 @@ 
Method Details

           },
           "updateTime": "A String", # Output only. The time this choice was updated last.
           "updater": { # Information about a user. # Output only. The user who updated this choice last.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
         },
-        "fieldId": "A String", # Required. The Selection Field in which a Choice will be created.
+        "fieldId": "A String", # Required. The selection field in which a choice will be created.
       },
-      "deleteField": { # Request to delete the Field. # Deletes a Field from the label.
-        "id": "A String", # Required. ID of the Field to delete.
+      "deleteField": { # Request to delete the field. # Deletes a field from the label.
+        "id": "A String", # Required. ID of the field to delete.
       },
-      "deleteSelectionChoice": { # Request to delete a Choice. # Delete a Choice within a Selection Field.
-        "fieldId": "A String", # Required. The Selection Field from which a Choice will be deleted.
+      "deleteSelectionChoice": { # Request to delete a choice. # Delete a choice within a selection field.
+        "fieldId": "A String", # Required. The selection field from which a choice will be deleted.
         "id": "A String", # Required. Choice to delete.
       },
-      "disableField": { # Request to disable the Field. # Disables the Field.
-        "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # Required. Field Disabled Policy.
+      "disableField": { # Request to disable the field. # Disables the field.
+        "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # Required. Field disabled policy.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
         },
-        "id": "A String", # Required. Key of the Field to disable.
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "id": "A String", # Required. Key of the field to disable.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
       },
-      "disableSelectionChoice": { # Request to disable a Choice. # Disable a Choice within a Selection Field.
+      "disableSelectionChoice": { # Request to disable a choice. # Disable a choice within a selection field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # Required. The disabled policy to update.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
         },
-        "fieldId": "A String", # Required. The Selection Field in which a Choice will be disabled.
+        "fieldId": "A String", # Required. The selection field in which a choice will be disabled.
         "id": "A String", # Required. Choice to disable.
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
       },
-      "enableField": { # Request to enable the Field. # Enables the Field.
-        "id": "A String", # Required. ID of the Field to enable.
+      "enableField": { # Request to enable the field. # Enables the field.
+        "id": "A String", # Required. ID of the field to enable.
       },
-      "enableSelectionChoice": { # Request to enable a Choice. # Enable a Choice within a Selection Field.
-        "fieldId": "A String", # Required. The Selection Field in which a Choice will be enabled.
+      "enableSelectionChoice": { # Request to enable a choice. # Enable a choice within a selection field.
+        "fieldId": "A String", # Required. The selection field in which a choice will be enabled.
         "id": "A String", # Required. Choice to enable.
       },
-      "updateField": { # Request to update Field properties. # Updates basic properties of a Field.
-        "id": "A String", # Required. The Field to update.
-        "properties": { # The basic properties of the field. # Required. Basic Field properties.
+      "updateField": { # Request to update field properties. # Updates basic properties of a field.
+        "id": "A String", # Required. The field to update.
+        "properties": { # The basic properties of the field. # Required. Basic field properties.
           "displayName": "A String", # Required. The display text to show in the UI identifying this field.
           "insertBeforeField": "A String", # Input only. Insert or move this field before the indicated field. If empty, the field is placed at the end of the list.
           "required": True or False, # Whether the field should be marked as required.
         },
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
       },
-      "updateFieldType": { # Request to change the type of a Field. # Update Field type and/or type options.
+      "updateFieldType": { # Request to change the type of a field. # Update field type and/or type options.
         "dateOptions": { # Options for the date field type. # Update field to Date.
           "dateFormat": "A String", # Output only. ICU date format.
           "dateFormatType": "A String", # Localized date formatting option. Field values are rendered in this format according to their locale.
@@ -1046,7 +1046,7 @@ 
Method Details

             "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
           },
         },
-        "id": "A String", # Required. The Field to update.
+        "id": "A String", # Required. The field to update.
         "integerOptions": { # Options for the Integer field type. # Update field to Integer.
           "maxValue": "A String", # Output only. The maximum valid value for the integer field.
           "minValue": "A String", # Output only. The minimum valid value for the integer field.
@@ -1061,11 +1061,11 @@ 
Method Details

               },
               "createTime": "A String", # Output only. The time this choice was created.
               "creator": { # Information about a user. # Output only. The user who created this choice.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
               "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
                 "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -1114,7 +1114,7 @@ 
Method Details

                 "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
               },
               "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-              "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+              "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
                 "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                   "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                   "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1122,8 +1122,8 @@ 
Method Details

                 "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
                 "state": "A String", # Output only. The state of the object associated with this lifecycle.
               },
-              "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-                "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+              "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+                "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
               },
               "properties": { # Basic properties of the choice. # Basic properties of the choice.
                 "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -1141,7 +1141,7 @@ 
Method Details

               },
               "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
               "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
                 "canDelete": True or False, # Whether the user can delete this choice.
@@ -1151,7 +1151,7 @@ 
Method Details

               },
               "updateTime": "A String", # Output only. The time this choice was updated last.
               "updater": { # Information about a user. # Output only. The user who updated this choice last.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
             },
           ],
@@ -1163,24 +1163,24 @@ 
Method Details

           "maxLength": 42, # Output only. The maximum valid length of values for the text field.
           "minLength": 42, # Output only. The minimum valid length of values for the text field.
         },
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root of `type_options` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root of `type_options` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
         "userOptions": { # Options for the user field type. # Update field to User.
           "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
             "maxEntries": 42, # Maximum number of entries permitted.
           },
         },
       },
-      "updateLabel": { # Updates basic properties of a Label. # Updates the Label properties.
+      "updateLabel": { # Updates basic properties of a label. # Updates the label properties.
         "properties": { # Basic properties of the label. # Required. Label properties to update.
           "description": "A String", # The description of the label.
           "title": "A String", # Required. Title of the label.
         },
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `label_properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `label_properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
       },
-      "updateSelectionChoiceProperties": { # Request to update a Choice properties. # Update a Choice properties within a Selection Field.
-        "fieldId": "A String", # Required. The Selection Field to update.
-        "id": "A String", # Required. The Choice to update.
-        "properties": { # Basic properties of the choice. # Required. The Choice properties to update.
+      "updateSelectionChoiceProperties": { # Request to update a choice property. # Update a choice property within a selection field.
+        "fieldId": "A String", # Required. The selection field to update.
+        "id": "A String", # Required. The choice to update.
+        "properties": { # Basic properties of the choice. # Required. The choice properties to update.
           "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
             "color": { # Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha <= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red << 16) | (green << 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i < missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ... # The color of the badge. When not specified, no badge is rendered. The background, foreground, and solo (light and dark mode) colors set here are changed in the Drive UI into the closest recommended supported color.
               "alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is, the final pixel color is defined by the equation: `pixel color = alpha * (this color) + (1.0 - alpha) * (background color)` This means that a value of 1.0 corresponds to a solid color, whereas a value of 0.0 corresponds to a completely transparent color. This uses a wrapper message rather than a simple float scalar so that it is possible to distinguish between a default value and the value being unset. If omitted, this color object is rendered as a solid color (as if the alpha value had been explicitly given a value of 1.0).
@@ -1194,14 +1194,14 @@ 
Method Details

           "displayName": "A String", # Required. The display text to show in the UI identifying this field.
           "insertBeforeChoice": "A String", # Input only. Insert or move this choice before the indicated choice. If empty, the choice is placed at the end of the list.
         },
-        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
+        "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
       },
     },
   ],
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   "view": "A String", # When specified, only certain fields belonging to the indicated view will be returned.
   "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed.
-    "requiredRevisionId": "A String", # The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
+    "requiredRevisionId": "A String", # The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
   },
 }
 
@@ -1213,42 +1213,42 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for Label update.
+    { # Response for label update.
   "responses": [ # The reply of the updates. This maps 1:1 with the updates, although responses to some requests may be empty.
     { # A single response from an update.
-      "createField": { # Response following Field create. # Creates a new Field.
+      "createField": { # Response following field create. # Creates a field.
         "id": "A String", # The field of the created field. When left blank in a create request, a key will be autogenerated and can be identified here.
         "priority": 42, # The priority of the created field. The priority may change from what was specified to assure contiguous priorities between fields (1-n).
       },
-      "createSelectionChoice": { # Response following Selection Choice create. # Creates a new selection list option to add to a Selection Field.
-        "fieldId": "A String", # The server-generated id of the field.
-        "id": "A String", # The server-generated ID of the created choice within the Field
+      "createSelectionChoice": { # Response following selection choice create. # Creates a selection list option to add to a selection field.
+        "fieldId": "A String", # The server-generated ID of the field.
+        "id": "A String", # The server-generated ID of the created choice within the field.
       },
-      "deleteField": { # Response following Field delete. # Deletes a Field from the label.
+      "deleteField": { # Response following field delete. # Deletes a field from the label.
       },
-      "deleteSelectionChoice": { # Response following Choice delete. # Deletes a Choice from a Selection Field.
+      "deleteSelectionChoice": { # Response following choice delete. # Deletes a choice from a selection field.
       },
-      "disableField": { # Response following Field disable. # Disables Field.
+      "disableField": { # Response following field disable. # Disables field.
       },
-      "disableSelectionChoice": { # Response following Choice disable. # Disables a Choice within a Selection Field.
+      "disableSelectionChoice": { # Response following choice disable. # Disables a choice within a selection field.
       },
-      "enableField": { # Response following Field enable. # Enables Field.
+      "enableField": { # Response following field enable. # Enables field.
       },
-      "enableSelectionChoice": { # Response following Choice enable. # Enables a Choice within a Selection Field.
+      "enableSelectionChoice": { # Response following choice enable. # Enables a choice within a selection field.
       },
-      "updateField": { # Response following update to Field properties. # Updates basic properties of a Field.
+      "updateField": { # Response following update to field properties. # Updates basic properties of a field.
         "priority": 42, # The priority of the updated field. The priority may change from what was specified to assure contiguous priorities between fields (1-n).
       },
-      "updateFieldType": { # Response following update to Field type. # Update Field type and/or type options.
+      "updateFieldType": { # Response following update to field type. # Updates field type and/or type options.
       },
-      "updateLabel": { # Response following update to Label properties. # Updated basic properties of a Label.
+      "updateLabel": { # Response following update to label properties. # Updates basic properties of a label.
       },
-      "updateSelectionChoiceProperties": { # Response following update to Selection Choice properties. # Updates a Choice within a Selection Field.
+      "updateSelectionChoiceProperties": { # Response following update to selection choice properties. # Updates a choice within a selection field.
         "priority": 42, # The priority of the updated choice. The priority may change from what was specified to assure contiguous priorities between choices (1-n).
       },
     },
   ],
-  "updatedLabel": { # A label defines a taxonomy that can be applied to Drive items in order to organize and search across items. Labels can be simple strings, or can contain fields that describe additional metadata that can be further used to organize and search Drive items. # The label after updates were applied. This is only set if [BatchUpdateLabelResponse2.include_label_in_response] is `true` and there were no errors.
+  "updatedLabel": { # A label defines a taxonomy that can be applied to Drive items in order to organize and search across items. Labels can be simple strings, or can contain fields that describe additional metadata that can be further used to organize and search Drive items. # The label after updates were applied. This is only set if `include_label_in_response` is `true` and there were no errors.
     "appliedCapabilities": { # The capabilities a user has on this label's applied metadata. # Output only. The capabilities related to this label on applied metadata.
       "canApply": True or False, # Whether the user can apply this label to items.
       "canRead": True or False, # Whether the user can read applied metadata related to this label.
@@ -1259,23 +1259,23 @@ 
Method Details

     },
     "createTime": "A String", # Output only. The time this label was created.
     "creator": { # Information about a user. # Output only. The user who created this label.
-      "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
     },
-    "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-    "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-    "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-      "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+    "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+    "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+      "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
     },
-    "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+    "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
       "disabled": True or False, # Whether the label should be shown in the UI as disabled.
       "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-      "priority": "A String", # Order to display label in a list.
+      "priority": "A String", # The order to display labels in a list.
       "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
     },
-    "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-      "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-        { # An App where the Label can be used.
-          "app": "A String", # Optional. The name of the App.
+    "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+      "enabledApps": [ # Optional. The list of apps where the label can be used.
+        { # An app where the label can be used.
+          "app": "A String", # Optional. The name of the app.
         },
       ],
     },
@@ -1288,7 +1288,7 @@ 
Method Details

         },
         "createTime": "A String", # Output only. The time this field was created.
         "creator": { # Information about a user. # Output only. The user who created this field.
-          "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+          "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
         },
         "dateOptions": { # Options for the date field type. # Date field options.
           "dateFormat": "A String", # Output only. ICU date format.
@@ -1306,7 +1306,7 @@ 
Method Details

         },
         "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
         "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-          "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+          "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
         },
         "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
           "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -1314,12 +1314,12 @@ 
Method Details

           "required": True or False, # Whether the field should be shown as required in the UI.
           "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
         },
-        "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+        "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
         "integerOptions": { # Options for the Integer field type. # Integer field options.
           "maxValue": "A String", # Output only. The maximum valid value for the integer field.
           "minValue": "A String", # Output only. The minimum valid value for the integer field.
         },
-        "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+        "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
           "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
             "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
             "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1327,8 +1327,8 @@ 
Method Details

           "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
           "state": "A String", # Output only. The state of the object associated with this lifecycle.
         },
-        "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-          "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+        "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+          "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
         },
         "properties": { # The basic properties of the field. # The basic properties of the field.
           "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -1336,7 +1336,7 @@ 
Method Details

           "required": True or False, # Whether the field should be marked as required.
         },
         "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-          "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+          "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
         },
         "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
         "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -1355,11 +1355,11 @@ 
Method Details

               },
               "createTime": "A String", # Output only. The time this choice was created.
               "creator": { # Information about a user. # Output only. The user who created this choice.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
               "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
                 "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -1408,7 +1408,7 @@ 
Method Details

                 "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
               },
               "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-              "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+              "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
                 "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                   "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                   "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1416,8 +1416,8 @@ 
Method Details

                 "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
                 "state": "A String", # Output only. The state of the object associated with this lifecycle.
               },
-              "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-                "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+              "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+                "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
               },
               "properties": { # Basic properties of the choice. # Basic properties of the choice.
                 "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -1435,7 +1435,7 @@ 
Method Details

               },
               "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
               "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
               "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
                 "canDelete": True or False, # Whether the user can delete this choice.
@@ -1445,7 +1445,7 @@ 
Method Details

               },
               "updateTime": "A String", # Output only. The time this choice was updated last.
               "updater": { # Information about a user. # Output only. The user who updated this choice last.
-                "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
               },
             },
           ],
@@ -1459,7 +1459,7 @@ 
Method Details

         },
         "updateTime": "A String", # Output only. The time this field was updated.
         "updater": { # Information about a user. # Output only. The user who modified this field.
-          "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+          "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
         },
         "userOptions": { # Options for the user field type. # User field options.
           "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -1468,10 +1468,10 @@ 
Method Details

         },
       },
     ],
-    "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+    "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
     "labelType": "A String", # Required. The type of label.
     "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-    "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+    "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
       "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
         "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
         "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1479,23 +1479,23 @@ 
Method Details

       "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
       "state": "A String", # Output only. The state of the object associated with this lifecycle.
     },
-    "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-      "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+    "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+      "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
     },
     "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
     "properties": { # Basic properties of the label. # Required. The basic properties of the label.
       "description": "A String", # The description of the label.
       "title": "A String", # Required. Title of the label.
     },
-    "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-    "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-      "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+    "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+      "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
     },
     "revisionCreateTime": "A String", # Output only. The time this label revision was created.
     "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-      "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
     },
-    "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+    "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
     "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
       "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
       "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -1508,23 +1508,23 @@ 
Method Details

 
 

     disable(name, body=None, x__xgafv=None)
-  
Disable a published Label. Disabling a Label will result in a new disabled published revision based on the current published revision. If there is a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.
+  
Disable a published label. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Disabling a label will result in a new disabled published revision based on the current published revision. If there's a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.
 
 Args:
   name: string, Required. Label resource name. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Request to deprecate a published Label.
+{ # Request to deprecate a published label.
   "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # Disabled policy to use.
     "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
     "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
   },
   "languageCode": "A String", # The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.
-  "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
-  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means last write wins.
-    "requiredRevisionId": "A String", # The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
+  "updateMask": "A String", # The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
+  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means the last write wins.
+    "requiredRevisionId": "A String", # The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
   },
 }
 
@@ -1547,23 +1547,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -1576,7 +1576,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -1594,7 +1594,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -1602,12 +1602,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1615,8 +1615,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -1624,7 +1624,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -1643,11 +1643,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -1696,7 +1696,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1704,8 +1704,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -1723,7 +1723,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -1733,7 +1733,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -1747,7 +1747,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -1756,10 +1756,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1767,23 +1767,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -1795,7 +1795,7 @@ 
Method Details

 
 

     enable(name, body=None, x__xgafv=None)
-  
Enable a disabled Label and restore it to its published state. This will result in a new published revision based on the current disabled published revision. If there is an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.
+  
Enable a disabled label and restore it to its published state. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). This will result in a new published revision based on the current disabled published revision. If there's an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.
 
 Args:
   name: string, Required. Label resource name. (required)
@@ -1804,9 +1804,9 @@ 
Method Details

 
 { # Request to enable a label.
   "languageCode": "A String", # The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
-  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means last write wins.
-    "requiredRevisionId": "A String", # The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
+  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means the last write wins.
+    "requiredRevisionId": "A String", # The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
   },
 }
 
@@ -1829,23 +1829,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -1858,7 +1858,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -1876,7 +1876,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -1884,12 +1884,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1897,8 +1897,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -1906,7 +1906,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -1925,11 +1925,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -1978,7 +1978,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -1986,8 +1986,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -2005,7 +2005,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -2015,7 +2015,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -2029,7 +2029,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -2038,10 +2038,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2049,23 +2049,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -2077,7 +2077,7 @@ 
Method Details

 
 

     get(name, languageCode=None, useAdminAccess=None, view=None, x__xgafv=None)
-  
Get a label by its resource name. Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.
+  
Get a label by its resource name. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label). Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.
 
 Args:
   name: string, Required. Label resource name. May be any of: * `labels/{id}` (equivalent to labels/{id}@latest) * `labels/{id}@latest` * `labels/{id}@published` * `labels/{id}@{revision_id}` (required)
@@ -2106,23 +2106,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -2135,7 +2135,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -2153,7 +2153,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -2161,12 +2161,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2174,8 +2174,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -2183,7 +2183,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -2202,11 +2202,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -2255,7 +2255,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2263,8 +2263,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -2282,7 +2282,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -2292,7 +2292,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -2306,7 +2306,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -2315,10 +2315,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2326,23 +2326,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -2354,12 +2354,12 @@ 
Method Details

 
 

     list(customer=None, languageCode=None, minimumRole=None, pageSize=None, pageToken=None, publishedOnly=None, useAdminAccess=None, view=None, x__xgafv=None)
-  
List labels.
+  
List labels. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label).
 
 Args:
-  customer: string, The customer to scope this list request to. For example: "customers/abcd1234". If unset, will return all labels within the current customer.
+  customer: string, The customer to scope this list request to. For example: `customers/abcd1234`. If unset, will return all labels within the current customer.
   languageCode: string, The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.
-  minimumRole: string, Specifies the level of access the user must have on the returned Labels. The minimum role a user must have on a label. Defaults to `READER`.
+  minimumRole: string, Specifies the level of access the user must have on the returned labels. The minimum role a user must have on a label. Defaults to `READER`.
     Allowed values
       LABEL_ROLE_UNSPECIFIED - Unknown role.
       READER - A reader can read the label and associated metadata applied to Drive items.
@@ -2369,7 +2369,7 @@ 
Method Details

   pageSize: integer, Maximum number of labels to return per page. Default: 50. Max: 200.
   pageToken: string, The token of the page to return.
   publishedOnly: boolean, Whether to include only published labels in the results. * When `true`, only the current published label revisions are returned. Disabled labels are included. Returned label resource names reference the published revision (`labels/{id}/{revision_id}`). * When `false`, the current label revisions are returned, which might not be published. Returned label resource names don't reference a specific revision (`labels/{id}`).
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. This will return all Labels within the customer.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. This will return all labels within the customer.
   view: string, When specified, only certain fields belonging to the indicated view are returned.
     Allowed values
       LABEL_VIEW_BASIC - Implies the field mask: `name,id,revision_id,label_type,properties.*`
@@ -2382,7 +2382,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for listing Labels.
+    { # Response for listing labels.
   "labels": [ # Labels.
     { # A label defines a taxonomy that can be applied to Drive items in order to organize and search across items. Labels can be simple strings, or can contain fields that describe additional metadata that can be further used to organize and search Drive items.
       "appliedCapabilities": { # The capabilities a user has on this label's applied metadata. # Output only. The capabilities related to this label on applied metadata.
@@ -2395,23 +2395,23 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this label was created.
       "creator": { # Information about a user. # Output only. The user who created this label.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
-      "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-      "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-      "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+      "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+      "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
-      "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+      "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
         "disabled": True or False, # Whether the label should be shown in the UI as disabled.
         "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-        "priority": "A String", # Order to display label in a list.
+        "priority": "A String", # The order to display labels in a list.
         "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
       },
-      "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-        "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-          { # An App where the Label can be used.
-            "app": "A String", # Optional. The name of the App.
+      "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+        "enabledApps": [ # Optional. The list of apps where the label can be used.
+          { # An app where the label can be used.
+            "app": "A String", # Optional. The name of the app.
           },
         ],
       },
@@ -2424,7 +2424,7 @@ 
Method Details

           },
           "createTime": "A String", # Output only. The time this field was created.
           "creator": { # Information about a user. # Output only. The user who created this field.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "dateOptions": { # Options for the date field type. # Date field options.
             "dateFormat": "A String", # Output only. ICU date format.
@@ -2442,7 +2442,7 @@ 
Method Details

           },
           "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
           "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
             "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -2450,12 +2450,12 @@ 
Method Details

             "required": True or False, # Whether the field should be shown as required in the UI.
             "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
           },
-          "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+          "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
           "integerOptions": { # Options for the Integer field type. # Integer field options.
             "maxValue": "A String", # Output only. The maximum valid value for the integer field.
             "minValue": "A String", # Output only. The minimum valid value for the integer field.
           },
-          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+          "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
             "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
               "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
               "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2463,8 +2463,8 @@ 
Method Details

             "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
             "state": "A String", # Output only. The state of the object associated with this lifecycle.
           },
-          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+          "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+            "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
           },
           "properties": { # The basic properties of the field. # The basic properties of the field.
             "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -2472,7 +2472,7 @@ 
Method Details

             "required": True or False, # Whether the field should be marked as required.
           },
           "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
           "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -2491,11 +2491,11 @@ 
Method Details

                 },
                 "createTime": "A String", # Output only. The time this choice was created.
                 "creator": { # Information about a user. # Output only. The user who created this choice.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
                 "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
                   "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -2544,7 +2544,7 @@ 
Method Details

                   "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
                 },
                 "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-                "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+                "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
                   "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                     "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                     "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2552,8 +2552,8 @@ 
Method Details

                   "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
                   "state": "A String", # Output only. The state of the object associated with this lifecycle.
                 },
-                "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-                  "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+                "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+                  "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
                 },
                 "properties": { # Basic properties of the choice. # Basic properties of the choice.
                   "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -2571,7 +2571,7 @@ 
Method Details

                 },
                 "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
                 "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
                 "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
                   "canDelete": True or False, # Whether the user can delete this choice.
@@ -2581,7 +2581,7 @@ 
Method Details

                 },
                 "updateTime": "A String", # Output only. The time this choice was updated last.
                 "updater": { # Information about a user. # Output only. The user who updated this choice last.
-                  "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+                  "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
                 },
               },
             ],
@@ -2595,7 +2595,7 @@ 
Method Details

           },
           "updateTime": "A String", # Output only. The time this field was updated.
           "updater": { # Information about a user. # Output only. The user who modified this field.
-            "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+            "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
           },
           "userOptions": { # Options for the user field type. # User field options.
             "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -2604,10 +2604,10 @@ 
Method Details

           },
         },
       ],
-      "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
       "labelType": "A String", # Required. The type of label.
       "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2615,23 +2615,23 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
       "properties": { # Basic properties of the label. # Required. The basic properties of the label.
         "description": "A String", # The description of the label.
         "title": "A String", # Required. Title of the label.
       },
-      "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-      "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+      "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "revisionCreateTime": "A String", # Output only. The time this label revision was created.
       "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
-      "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+      "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
       "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
         "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
         "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -2660,7 +2660,7 @@ 
Method Details

 
 

     publish(name, body=None, x__xgafv=None)
-  
Publish all draft changes to the Label. Once published, the Label may not return to its draft state. See `google.apps.drive.labels.v2.Lifecycle` for more information. Publishing a Label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the Label will be rejected. For example, the following changes to a Label will be rejected after the Label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * Field.FieldType cannot be changed. * Changes to Field validation options cannot reject something that was previously accepted. * Reducing the max entries.
+  
Publish all draft changes to the label. Once published, the label may not return to its draft state. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label). Publishing a label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label will be rejected. For example, the following changes to a label will be rejected after the label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * `Field.FieldType` cannot be changed. * Changes to field validation options cannot reject something that was previously accepted. * Reducing the maximum entries.
 
 Args:
   name: string, Required. Label resource name. (required)
@@ -2669,9 +2669,9 @@ 
Method Details

 
 { # Request to publish a label.
   "languageCode": "A String", # The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
-  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means last write wins.
-    "requiredRevisionId": "A String", # The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
+  "writeControl": { # Provides control over how write requests are executed. When not specified, the last write wins. # Provides control over how write requests are executed. Defaults to unset, which means the last write wins.
+    "requiredRevisionId": "A String", # The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
   },
 }
 
@@ -2694,23 +2694,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -2723,7 +2723,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -2741,7 +2741,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -2749,12 +2749,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2762,8 +2762,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -2771,7 +2771,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -2790,11 +2790,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -2843,7 +2843,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2851,8 +2851,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -2870,7 +2870,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -2880,7 +2880,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -2894,7 +2894,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -2903,10 +2903,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -2914,23 +2914,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -2942,17 +2942,17 @@ 
Method Details

 
 

     updateLabelCopyMode(name, body=None, x__xgafv=None)
-  
Updates a Label's `CopyMode`. Changes to this policy are not revisioned, do not require publishing, and take effect immediately.
+  
Updates a label's `CopyMode`. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately.
 
 Args:
-  name: string, Required. The resource name of the Label to update. (required)
+  name: string, Required. The resource name of the label to update. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Request to update the `CopyMode` of the given Label. Changes to this policy are not revisioned, do not require publishing, and take effect immediately. \
-  "copyMode": "A String", # Required. Indicates how the applied Label, and Field values should be copied when a Drive item is copied.
+{ # Request to update the `CopyMode` of the given label. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately. \
+  "copyMode": "A String", # Required. Indicates how the applied label and field values should be copied when a Drive item is copied.
   "languageCode": "A String", # The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   "view": "A String", # When specified, only certain fields belonging to the indicated view will be returned.
 }
 
@@ -2975,23 +2975,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -3004,7 +3004,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -3022,7 +3022,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -3030,12 +3030,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3043,8 +3043,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -3052,7 +3052,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -3071,11 +3071,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -3124,7 +3124,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3132,8 +3132,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -3151,7 +3151,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -3161,7 +3161,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -3175,7 +3175,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -3184,10 +3184,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3195,23 +3195,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -3223,23 +3223,23 @@ 
Method Details

 
 

     updateLabelEnabledAppSettings(name, body=None, x__xgafv=None)
-  
Updates a Label's EabledAppSettings. Enabling a Label in a Workspace Application allows it to be used in that application. This change is not revisioned, does not require publishing, and takes effect immediately.
+  
Updates a label's `EnabledAppSettings`. Enabling a label in a Google Workspace app allows it to be used in that app. This change isn't revisioned, doesn't require publishing, and takes effect immediately.
 
 Args:
-  name: string, Required. The resource name of the Label to update. The resource name of the Label to update. (required)
+  name: string, Required. The resource name of the label to update. The resource name of the label to update. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Request to update the `EnabledAppSettings` of the given Label. This change is not revisioned, does not require publishing, and takes effect immediately. \
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Required. The new `EnabledAppSettings` value for the Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+{ # Request to update the `EnabledAppSettings` of the given label. This change is not revisioned, doesn't require publishing, and takes effect immediately. \
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Required. The new `EnabledAppSettings` value for the label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
   "languageCode": "A String", # Optional. The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.
-  "useAdminAccess": True or False, # Optional. Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  "useAdminAccess": True or False, # Optional. Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   "view": "A String", # Optional. When specified, only certain fields belonging to the indicated view will be returned.
 }
 
@@ -3262,23 +3262,23 @@ 
Method Details

   },
   "createTime": "A String", # Output only. The time this label was created.
   "creator": { # Information about a user. # Output only. The user who created this label.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "customer": "A String", # Output only. The customer this label belongs to. For example: "customers/123abc789."
-  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label is not disabled.
-  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label is not disabled.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "customer": "A String", # Output only. The customer this label belongs to. For example: `customers/123abc789`.
+  "disableTime": "A String", # Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.
+  "disabler": { # Information about a user. # Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "displayHints": { # UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
+  "displayHints": { # The UI display hints for rendering the label. # Output only. UI display hints for rendering the label.
     "disabled": True or False, # Whether the label should be shown in the UI as disabled.
     "hiddenInSearch": True or False, # This label should be hidden in the search menu when searching for Drive items.
-    "priority": "A String", # Order to display label in a list.
+    "priority": "A String", # The order to display labels in a list.
     "shownInApply": True or False, # This label should be shown in the apply menu when applying values to a Drive item.
   },
-  "enabledAppSettings": { # Describes the Workspace apps in which the Label can be used. # Optional. The EnabledAppSettings for this Label.
-    "enabledApps": [ # Optional. The list of Apps where the Label can be used.
-      { # An App where the Label can be used.
-        "app": "A String", # Optional. The name of the App.
+  "enabledAppSettings": { # Describes the Google Workspace apps in which the label can be used. # Optional. The `EnabledAppSettings` for this Label.
+    "enabledApps": [ # Optional. The list of apps where the label can be used.
+      { # An app where the label can be used.
+        "app": "A String", # Optional. The name of the app.
       },
     ],
   },
@@ -3291,7 +3291,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. The time this field was created.
       "creator": { # Information about a user. # Output only. The user who created this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "dateOptions": { # Options for the date field type. # Date field options.
         "dateFormat": "A String", # Output only. ICU date format.
@@ -3309,7 +3309,7 @@ 
Method Details

       },
       "disableTime": "A String", # Output only. The time this field was disabled. This value has no meaning when the field is not disabled.
       "disabler": { # Information about a user. # Output only. The user who disabled this field. This value has no meaning when the field is not disabled.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "displayHints": { # UI display hints for rendering a field. # Output only. UI display hints for rendering a field.
         "disabled": True or False, # Whether the field should be shown in the UI as disabled.
@@ -3317,12 +3317,12 @@ 
Method Details

         "required": True or False, # Whether the field should be shown as required in the UI.
         "shownInApply": True or False, # This field should be shown in the apply menu when applying values to a Drive item.
       },
-      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`
+      "id": "A String", # Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.
       "integerOptions": { # Options for the Integer field type. # Integer field options.
         "maxValue": "A String", # Output only. The maximum valid value for the integer field.
         "minValue": "A String", # Output only. The minimum valid value for the integer field.
       },
-      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
+      "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle of this field.
         "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
           "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
           "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3330,8 +3330,8 @@ 
Method Details

         "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
         "state": "A String", # Output only. The state of the object associated with this lifecycle.
       },
-      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this field.
-        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+      "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this field.
+        "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
       },
       "properties": { # The basic properties of the field. # The basic properties of the field.
         "displayName": "A String", # Required. The display text to show in the UI identifying this field.
@@ -3339,7 +3339,7 @@ 
Method Details

         "required": True or False, # Whether the field should be marked as required.
       },
       "publisher": { # Information about a user. # Output only. The user who published this field. This value has no meaning when the field is not published.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "queryKey": "A String", # Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, "`{query_key}` > 2001-01-01".
       "schemaCapabilities": { # The capabilities related to this field when editing the field. # Output only. The capabilities this user has when editing this field.
@@ -3358,11 +3358,11 @@ 
Method Details

             },
             "createTime": "A String", # Output only. The time this choice was created.
             "creator": { # Information about a user. # Output only. The user who created this choice.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "disableTime": "A String", # Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.
             "disabler": { # Information about a user. # Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "displayHints": { # UI display hints for rendering an option. # Output only. UI display hints for rendering a choice.
               "badgeColors": { # The color derived from BadgeConfig and changed to the closest recommended supported color. # The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.
@@ -3411,7 +3411,7 @@ 
Method Details

               "shownInApply": True or False, # This option should be shown in the apply menu when applying values to a Drive item.
             },
             "id": "A String", # The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.
-            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
+            "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. Lifecycle of the choice.
               "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
                 "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
                 "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3419,8 +3419,8 @@ 
Method Details

               "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
               "state": "A String", # Output only. The state of the object associated with this lifecycle.
             },
-            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this choice.
-              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+            "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this choice.
+              "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
             },
             "properties": { # Basic properties of the choice. # Basic properties of the choice.
               "badgeConfig": { # Badge status of the label. # The badge configuration for this choice. When set, the label that owns this choice is considered a "badged label".
@@ -3438,7 +3438,7 @@ 
Method Details

             },
             "publishTime": "A String", # Output only. The time this choice was published. This value has no meaning when the choice is not published.
             "publisher": { # Information about a user. # Output only. The user who published this choice. This value has no meaning when the choice is not published.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
             "schemaCapabilities": { # The capabilities related to this choice when editing the choice. # Output only. The capabilities related to this option when editing the option.
               "canDelete": True or False, # Whether the user can delete this choice.
@@ -3448,7 +3448,7 @@ 
Method Details

             },
             "updateTime": "A String", # Output only. The time this choice was updated last.
             "updater": { # Information about a user. # Output only. The user who updated this choice last.
-              "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+              "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
             },
           },
         ],
@@ -3462,7 +3462,7 @@ 
Method Details

       },
       "updateTime": "A String", # Output only. The time this field was updated.
       "updater": { # Information about a user. # Output only. The user who modified this field.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
       "userOptions": { # Options for the user field type. # User field options.
         "listOptions": { # Options for a multi-valued variant of an associated field type. # When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.
@@ -3471,10 +3471,10 @@ 
Method Details

       },
     },
   ],
-  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`
+  "id": "A String", # Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.
   "labelType": "A String", # Required. The type of label.
   "learnMoreUri": "A String", # Custom URL to present to users to allow them to learn more about this label and how it should be used.
-  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
+  "lifecycle": { # The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect. # Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.
     "disabledPolicy": { # The policy that governs how to treat a disabled label, field, or selection choice in different contexts. # The policy that governs how to show a disabled label, field, or selection choice.
       "hideInSearch": True or False, # Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.
       "showInApply": True or False, # Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
@@ -3482,23 +3482,23 @@ 
Method Details

     "hasUnpublishedChanges": True or False, # Output only. Whether the object associated with this lifecycle has unpublished changes.
     "state": "A String", # Output only. The state of the object associated with this lifecycle.
   },
-  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The LockStatus of this label.
-    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.
+  "lockStatus": { # Contains information about whether a label component should be considered locked. # Output only. The `LockStatus` of this label.
+    "locked": True or False, # Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.
   },
   "name": "A String", # Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.
   "properties": { # Basic properties of the label. # Required. The basic properties of the label.
     "description": "A String", # The description of the label.
     "title": "A String", # Required. Title of the label.
   },
-  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label is not published.
-  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label is not published.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+  "publishTime": "A String", # Output only. The time this label was published. This value has no meaning when the label isn't published.
+  "publisher": { # Information about a user. # Output only. The user who published this label. This value has no meaning when the label isn't published.>>
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
   "revisionCreateTime": "A String", # Output only. The time this label revision was created.
   "revisionCreator": { # Information about a user. # Output only. The user who created this label revision.
-    "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+    "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
   },
-  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`
+  "revisionId": "A String", # Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.
   "schemaCapabilities": { # The capabilities related to this label when editing the label. # Output only. The capabilities the user has on this label.
     "canDelete": True or False, # Whether the user can delete this label. The user must have permission and the label must be disabled.
     "canDisable": True or False, # Whether the user can disable this label. The user must have permission and this label must not already be disabled.
@@ -3510,23 +3510,23 @@ 
Method Details

 
 

     updatePermissions(parent, body=None, useAdminAccess=None, x__xgafv=None)
-  
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name. (required)
+  parent: string, Required. The parent label resource name. (required)
   body: object, The request body.
     The object takes the form of:
 
 { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
   "role": "A String", # The role the principal should have.
 }
 
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -3536,8 +3536,8 @@ 
Method Details

   An object of the form:
 
     { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
diff --git a/docs/dyn/drivelabels_v2beta.labels.locks.html b/docs/dyn/drivelabels_v2beta.labels.locks.html
index 7b20e78b1a9..d5306fa561e 100644
--- a/docs/dyn/drivelabels_v2beta.labels.locks.html
+++ b/docs/dyn/drivelabels_v2beta.labels.locks.html
@@ -79,7 +79,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

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

-
Lists the LabelLocks on a Label.

+
Lists the label locks on a label.

 

   list_next()

 
Retrieves the next page of results.

@@ -91,11 +91,11 @@ 
Method Details

 
 

     list(parent, pageSize=None, pageToken=None, x__xgafv=None)
-  
Lists the LabelLocks on a Label.
+  
Lists the label locks on a label.
 
 Args:
-  parent: string, Required. Label on which Locks are applied. Format: labels/{label} (required)
-  pageSize: integer, Maximum number of Locks to return per page. Default: 100. Max: 200.
+  parent: string, Required. Label on which locks are applied. Format: `labels/{label}`. (required)
+  pageSize: integer, Maximum number of locks to return per page. Default: 100. Max: 200.
   pageToken: string, The token of the page to return.
   x__xgafv: string, V1 error format.
     Allowed values
@@ -105,21 +105,21 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # The response to a ListLabelLocksRequest.
-  "labelLocks": [ # LabelLocks.
-    { # A Lock that can be applied to a Label, Field, or Choice.
-      "capabilities": { # A description of a user's capabilities on a LabelLock. # Output only. The user's capabilities on this LabelLock.
+    { # The response to a `ListLabelLocksRequest`.
+  "labelLocks": [ # Label locks.
+    { # A lock that can be applied to a label, field, or choice.
+      "capabilities": { # A description of a user's capabilities on a label lock. # Output only. The user's capabilities on this label lock.
         "canViewPolicy": True or False, # True if the user is authorized to view the policy.
       },
-      "choiceId": "A String", # The ID of the Selection Field Choice that should be locked. If present, `field_id` must also be present.
-      "createTime": "A String", # Output only. The time this LabelLock was created.
-      "creator": { # Information about a user. # Output only. The user whose credentials were used to create the LabelLock. This will not be present if no user was responsible for creating the LabelLock.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "choiceId": "A String", # The ID of the selection field choice that should be locked. If present, `field_id` must also be present.
+      "createTime": "A String", # Output only. The time this label lock was created.
+      "creator": { # Information about a user. # Output only. The user whose credentials were used to create the label lock. Not present if no user was responsible for creating the label lock.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
-      "deleteTime": "A String", # Output only. A timestamp indicating when this LabelLock was scheduled for deletion. This will be present only if this LabelLock is in the DELETING state.
-      "fieldId": "A String", # The ID of the Field that should be locked. Empty if the whole Label should be locked.
-      "name": "A String", # Output only. Resource name of this LabelLock.
-      "state": "A String", # Output only. This LabelLock's state.
+      "deleteTime": "A String", # Output only. A timestamp indicating when this label lock was scheduled for deletion. Present only if this label lock is in the `DELETING` state.
+      "fieldId": "A String", # The ID of the field that should be locked. Empty if the whole label should be locked.
+      "name": "A String", # Output only. Resource name of this label lock.
+      "state": "A String", # Output only. This label lock's state.
     },
   ],
   "nextPageToken": "A String", # The token of the next page in the response.
diff --git a/docs/dyn/drivelabels_v2beta.labels.permissions.html b/docs/dyn/drivelabels_v2beta.labels.permissions.html
index 65b35dd6616..3c3ed65d19d 100644
--- a/docs/dyn/drivelabels_v2beta.labels.permissions.html
+++ b/docs/dyn/drivelabels_v2beta.labels.permissions.html
@@ -76,43 +76,43 @@ 
Drive Labels API . 
   batchDelete(parent, body=None, x__xgafv=None)

-
Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

   close()

 
Close httplib2 connections.

 

   create(parent, body=None, useAdminAccess=None, x__xgafv=None)

-
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Lists a Label's permissions.

+
Lists a label's permissions.

 

   list_next()

 
Retrieves the next page of results.

 
Method Details

 

     batchDelete(parent, body=None, x__xgafv=None)
-  
Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name shared by all permissions being deleted. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field. (required)
+  parent: string, Required. The parent label resource name shared by all permissions being deleted. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Deletes one of more Label Permissions.
+{ # Deletes one or more label permissions.
   "requests": [ # Required. The request message specifying the resources to update.
-    { # Deletes a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
-      "name": "A String", # Required. Label Permission resource name.
-      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+    { # Deletes a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
+      "name": "A String", # Required. Label permission resource name.
+      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
     },
   ],
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the DeleteLabelPermissionRequest messages must either be empty or match this field.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `DeleteLabelPermissionRequest` messages must either be empty or match this field.
 }
 
   x__xgafv: string, V1 error format.
@@ -129,29 +129,29 @@ 
Method Details

 
 

     batchUpdate(parent, body=None, x__xgafv=None)
-  
Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name shared by all permissions being updated. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field. (required)
+  parent: string, Required. The parent label resource name shared by all permissions being updated. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Updates one or more Label Permissions.
+{ # Updates one or more label permissions.
   "requests": [ # Required. The request message specifying the resources to update.
-    { # Updates a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
-      "labelPermission": { # The permission that applies to a principal (user, group, audience) on a label. # Required. The permission to create or update on the Label.
-        "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-        "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+    { # Updates a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
+      "labelPermission": { # The permission that applies to a principal (user, group, audience) on a label. # Required. The permission to create or update on the label.
+        "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+        "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
         "group": "A String", # Group resource name.
         "name": "A String", # Resource name of this permission.
         "person": "A String", # Person resource name.
         "role": "A String", # The role the principal should have.
       },
-      "parent": "A String", # Required. The parent Label resource name.
-      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+      "parent": "A String", # Required. The parent label resource name.
+      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
     },
   ],
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the UpdateLabelPermissionRequest messages must either be empty or match this field.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.
 }
 
   x__xgafv: string, V1 error format.
@@ -162,11 +162,11 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for updating one or more Label Permissions.
+    { # Response for updating one or more label permissions.
   "permissions": [ # Required. Permissions updated.
     { # The permission that applies to a principal (user, group, audience) on a label.
-      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-      "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+      "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
       "group": "A String", # Group resource name.
       "name": "A String", # Resource name of this permission.
       "person": "A String", # Person resource name.
@@ -183,23 +183,23 @@ 
Method Details

 
 

     create(parent, body=None, useAdminAccess=None, x__xgafv=None)
-  
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name on the Label Permission is created. Format: labels/{label} (required)
+  parent: string, Required. The parent label resource name on the label permission is created. Format: `labels/{label}`. (required)
   body: object, The request body.
     The object takes the form of:
 
 { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
   "role": "A String", # The role the principal should have.
 }
 
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -209,8 +209,8 @@ 
Method Details

   An object of the form:
 
     { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
@@ -220,11 +220,11 @@ 
Method Details

 
 

     delete(name, useAdminAccess=None, x__xgafv=None)
-  
Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  name: string, Required. Label Permission resource name. (required)
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  name: string, Required. Label permission resource name. (required)
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -239,13 +239,13 @@ 
Method Details

 
 

     list(parent, pageSize=None, pageToken=None, useAdminAccess=None, x__xgafv=None)
-  
Lists a Label's permissions.
+  
Lists a label's permissions.
 
 Args:
-  parent: string, Required. The parent Label resource name on which Label Permission are listed. Format: labels/{label} (required)
+  parent: string, Required. The parent label resource name on which label permissions are listed. Format: `labels/{label}`. (required)
   pageSize: integer, Maximum number of permissions to return per page. Default: 50. Max: 200.
   pageToken: string, The token of the page to return.
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -254,11 +254,11 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for listing the permissions on a Label.
+    { # Response for listing the permissions on a label.
   "labelPermissions": [ # Label permissions.
     { # The permission that applies to a principal (user, group, audience) on a label.
-      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-      "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+      "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
       "group": "A String", # Group resource name.
       "name": "A String", # Resource name of this permission.
       "person": "A String", # Person resource name.
diff --git a/docs/dyn/drivelabels_v2beta.labels.revisions.html b/docs/dyn/drivelabels_v2beta.labels.revisions.html
index 06b758905ac..444ce2c1510 100644
--- a/docs/dyn/drivelabels_v2beta.labels.revisions.html
+++ b/docs/dyn/drivelabels_v2beta.labels.revisions.html
@@ -89,7 +89,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

   updatePermissions(parent, body=None, useAdminAccess=None, x__xgafv=None)

-
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 
Method Details

 

     close()
@@ -98,23 +98,23 @@ 
Method Details

 
 

     updatePermissions(parent, body=None, useAdminAccess=None, x__xgafv=None)
-  
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name. (required)
+  parent: string, Required. The parent label resource name. (required)
   body: object, The request body.
     The object takes the form of:
 
 { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
   "role": "A String", # The role the principal should have.
 }
 
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -124,8 +124,8 @@ 
Method Details

   An object of the form:
 
     { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
diff --git a/docs/dyn/drivelabels_v2beta.labels.revisions.locks.html b/docs/dyn/drivelabels_v2beta.labels.revisions.locks.html
index b300a5be0f0..8b36209a1d4 100644
--- a/docs/dyn/drivelabels_v2beta.labels.revisions.locks.html
+++ b/docs/dyn/drivelabels_v2beta.labels.revisions.locks.html
@@ -79,7 +79,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

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

-
Lists the LabelLocks on a Label.

+
Lists the label locks on a label.

 

   list_next()

 
Retrieves the next page of results.

@@ -91,11 +91,11 @@ 
Method Details

 
 

     list(parent, pageSize=None, pageToken=None, x__xgafv=None)
-  
Lists the LabelLocks on a Label.
+  
Lists the label locks on a label.
 
 Args:
-  parent: string, Required. Label on which Locks are applied. Format: labels/{label} (required)
-  pageSize: integer, Maximum number of Locks to return per page. Default: 100. Max: 200.
+  parent: string, Required. Label on which locks are applied. Format: `labels/{label}`. (required)
+  pageSize: integer, Maximum number of locks to return per page. Default: 100. Max: 200.
   pageToken: string, The token of the page to return.
   x__xgafv: string, V1 error format.
     Allowed values
@@ -105,21 +105,21 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # The response to a ListLabelLocksRequest.
-  "labelLocks": [ # LabelLocks.
-    { # A Lock that can be applied to a Label, Field, or Choice.
-      "capabilities": { # A description of a user's capabilities on a LabelLock. # Output only. The user's capabilities on this LabelLock.
+    { # The response to a `ListLabelLocksRequest`.
+  "labelLocks": [ # Label locks.
+    { # A lock that can be applied to a label, field, or choice.
+      "capabilities": { # A description of a user's capabilities on a label lock. # Output only. The user's capabilities on this label lock.
         "canViewPolicy": True or False, # True if the user is authorized to view the policy.
       },
-      "choiceId": "A String", # The ID of the Selection Field Choice that should be locked. If present, `field_id` must also be present.
-      "createTime": "A String", # Output only. The time this LabelLock was created.
-      "creator": { # Information about a user. # Output only. The user whose credentials were used to create the LabelLock. This will not be present if no user was responsible for creating the LabelLock.
-        "person": "A String", # The identifier for this user that can be used with the People API to get more information. For example, people/12345678.
+      "choiceId": "A String", # The ID of the selection field choice that should be locked. If present, `field_id` must also be present.
+      "createTime": "A String", # Output only. The time this label lock was created.
+      "creator": { # Information about a user. # Output only. The user whose credentials were used to create the label lock. Not present if no user was responsible for creating the label lock.
+        "person": "A String", # The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.
       },
-      "deleteTime": "A String", # Output only. A timestamp indicating when this LabelLock was scheduled for deletion. This will be present only if this LabelLock is in the DELETING state.
-      "fieldId": "A String", # The ID of the Field that should be locked. Empty if the whole Label should be locked.
-      "name": "A String", # Output only. Resource name of this LabelLock.
-      "state": "A String", # Output only. This LabelLock's state.
+      "deleteTime": "A String", # Output only. A timestamp indicating when this label lock was scheduled for deletion. Present only if this label lock is in the `DELETING` state.
+      "fieldId": "A String", # The ID of the field that should be locked. Empty if the whole label should be locked.
+      "name": "A String", # Output only. Resource name of this label lock.
+      "state": "A String", # Output only. This label lock's state.
     },
   ],
   "nextPageToken": "A String", # The token of the next page in the response.
diff --git a/docs/dyn/drivelabels_v2beta.labels.revisions.permissions.html b/docs/dyn/drivelabels_v2beta.labels.revisions.permissions.html
index 12195b56c57..92eef70d718 100644
--- a/docs/dyn/drivelabels_v2beta.labels.revisions.permissions.html
+++ b/docs/dyn/drivelabels_v2beta.labels.revisions.permissions.html
@@ -76,43 +76,43 @@ 
Drive Labels API . 
   batchDelete(parent, body=None, x__xgafv=None)

-
Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

   close()

 
Close httplib2 connections.

 

   create(parent, body=None, useAdminAccess=None, x__xgafv=None)

-
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

+
Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

 

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

-
Lists a Label's permissions.

+
Lists a label's permissions.

 

   list_next()

 
Retrieves the next page of results.

 
Method Details

 

     batchDelete(parent, body=None, x__xgafv=None)
-  
Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name shared by all permissions being deleted. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field. (required)
+  parent: string, Required. The parent label resource name shared by all permissions being deleted. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Deletes one of more Label Permissions.
+{ # Deletes one or more label permissions.
   "requests": [ # Required. The request message specifying the resources to update.
-    { # Deletes a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
-      "name": "A String", # Required. Label Permission resource name.
-      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+    { # Deletes a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
+      "name": "A String", # Required. Label permission resource name.
+      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
     },
   ],
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the DeleteLabelPermissionRequest messages must either be empty or match this field.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `DeleteLabelPermissionRequest` messages must either be empty or match this field.
 }
 
   x__xgafv: string, V1 error format.
@@ -129,29 +129,29 @@ 
Method Details

 
 

     batchUpdate(parent, body=None, x__xgafv=None)
-  
Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name shared by all permissions being updated. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field. (required)
+  parent: string, Required. The parent label resource name shared by all permissions being updated. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Updates one or more Label Permissions.
+{ # Updates one or more label permissions.
   "requests": [ # Required. The request message specifying the resources to update.
-    { # Updates a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
-      "labelPermission": { # The permission that applies to a principal (user, group, audience) on a label. # Required. The permission to create or update on the Label.
-        "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-        "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+    { # Updates a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
+      "labelPermission": { # The permission that applies to a principal (user, group, audience) on a label. # Required. The permission to create or update on the label.
+        "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+        "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
         "group": "A String", # Group resource name.
         "name": "A String", # Resource name of this permission.
         "person": "A String", # Person resource name.
         "role": "A String", # The role the principal should have.
       },
-      "parent": "A String", # Required. The parent Label resource name.
-      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+      "parent": "A String", # Required. The parent label resource name.
+      "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
     },
   ],
-  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the UpdateLabelPermissionRequest messages must either be empty or match this field.
+  "useAdminAccess": True or False, # Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.
 }
 
   x__xgafv: string, V1 error format.
@@ -162,11 +162,11 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for updating one or more Label Permissions.
+    { # Response for updating one or more label permissions.
   "permissions": [ # Required. Permissions updated.
     { # The permission that applies to a principal (user, group, audience) on a label.
-      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-      "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+      "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
       "group": "A String", # Group resource name.
       "name": "A String", # Resource name of this permission.
       "person": "A String", # Person resource name.
@@ -183,23 +183,23 @@ 
Method Details

 
 

     create(parent, body=None, useAdminAccess=None, x__xgafv=None)
-  
Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  parent: string, Required. The parent Label resource name on the Label Permission is created. Format: labels/{label} (required)
+  parent: string, Required. The parent label resource name on the label permission is created. Format: `labels/{label}`. (required)
   body: object, The request body.
     The object takes the form of:
 
 { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
   "role": "A String", # The role the principal should have.
 }
 
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -209,8 +209,8 @@ 
Method Details

   An object of the form:
 
     { # The permission that applies to a principal (user, group, audience) on a label.
-  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-  "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+  "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+  "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
   "group": "A String", # Group resource name.
   "name": "A String", # Resource name of this permission.
   "person": "A String", # Person resource name.
@@ -220,11 +220,11 @@ 
Method Details

 
 

     delete(name, useAdminAccess=None, x__xgafv=None)
-  
Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
+  
Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.
 
 Args:
-  name: string, Required. Label Permission resource name. (required)
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  name: string, Required. Label permission resource name. (required)
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -239,13 +239,13 @@ 
Method Details

 
 

     list(parent, pageSize=None, pageToken=None, useAdminAccess=None, x__xgafv=None)
-  
Lists a Label's permissions.
+  
Lists a label's permissions.
 
 Args:
-  parent: string, Required. The parent Label resource name on which Label Permission are listed. Format: labels/{label} (required)
+  parent: string, Required. The parent label resource name on which label permissions are listed. Format: `labels/{label}`. (required)
   pageSize: integer, Maximum number of permissions to return per page. Default: 50. Max: 200.
   pageToken: string, The token of the page to return.
-  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.
+  useAdminAccess: boolean, Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -254,11 +254,11 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response for listing the permissions on a Label.
+    { # Response for listing the permissions on a label.
   "labelPermissions": [ # Label permissions.
     { # The permission that applies to a principal (user, group, audience) on a label.
-      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.
-      "email": "A String", # Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.
+      "audience": "A String", # Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.
+      "email": "A String", # Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
       "group": "A String", # Group resource name.
       "name": "A String", # Resource name of this permission.
       "person": "A String", # Person resource name.
diff --git a/docs/dyn/drivelabels_v2beta.limits.html b/docs/dyn/drivelabels_v2beta.limits.html
index 56b4f2f6391..ea65fa3dfd5 100644
--- a/docs/dyn/drivelabels_v2beta.limits.html
+++ b/docs/dyn/drivelabels_v2beta.limits.html
@@ -79,7 +79,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

   getLabel(name=None, x__xgafv=None)

-
Get the constraints on the structure of a Label; such as, the maximum number of Fields allowed and maximum length of the label title.

+
Get the constraints on the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.

 
Method Details

 

     close()
@@ -88,10 +88,10 @@ 
Method Details

 
 

     getLabel(name=None, x__xgafv=None)
-  
Get the constraints on the structure of a Label; such as, the maximum number of Fields allowed and maximum length of the label title.
+  
Get the constraints on the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.
 
 Args:
-  name: string, Required. Label revision resource name Must be: "limits/label"
+  name: string, Required. Label revision resource name must be: "limits/label".
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -100,54 +100,54 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Label constraints governing the structure of a Label; such as, the maximum number of Fields allowed and maximum length of the label title.
-  "fieldLimits": { # Field constants governing the structure of a Field; such as, the maximum title length, minimum and maximum field values or length, etc. # The limits for Fields.
-    "dateLimits": { # Limits for date Field type. # Date Field limits.
-      "maxValue": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Maximum value for the date Field type.
+    { # Label constraints governing the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.
+  "fieldLimits": { # Field constants governing the structure of a field; such as, the maximum title length, minimum and maximum field values or length, etc. # The limits for fields.
+    "dateLimits": { # Limits for date field type. # Date field limits.
+      "maxValue": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Maximum value for the date field type.
         "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
         "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
         "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
       },
-      "minValue": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Minimum value for the date Field type.
+      "minValue": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Minimum value for the date field type.
         "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
         "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
         "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
       },
     },
-    "integerLimits": { # Limits for integer Field type. # Integer Field limits.
-      "maxValue": "A String", # Maximum value for an integer Field type.
-      "minValue": "A String", # Minimum value for an integer Field type.
+    "integerLimits": { # Limits for integer field type. # Integer field limits.
+      "maxValue": "A String", # Maximum value for an integer field type.
+      "minValue": "A String", # Minimum value for an integer field type.
     },
-    "longTextLimits": { # Limits for long text Field type. # Long text Field limits.
-      "maxLength": 42, # Maximum length allowed for a long text Field type.
-      "minLength": 42, # Minimum length allowed for a long text Field type.
+    "longTextLimits": { # Limits for long text field type. # Long text field limits.
+      "maxLength": 42, # Maximum length allowed for a long text field type.
+      "minLength": 42, # Minimum length allowed for a long text field type.
     },
-    "maxDescriptionLength": 42, # Limits for Field description, also called help text.
-    "maxDisplayNameLength": 42, # Limits for Field title.
-    "maxIdLength": 42, # Max length for the id.
-    "selectionLimits": { # Limits for selection Field type. # Selection Field limits.
-      "listLimits": { # Limits for list-variant of a Field type. # Limits for list-variant of a Field type.
-        "maxEntries": 42, # Maximum number of values allowed for the Field type.
+    "maxDescriptionLength": 42, # Limits for field description, also called help text.
+    "maxDisplayNameLength": 42, # Limits for field title.
+    "maxIdLength": 42, # Maximum length for the id.
+    "selectionLimits": { # Limits for selection field type. # Selection field limits.
+      "listLimits": { # Limits for list-variant of a field type. # Limits for list-variant of a field type.
+        "maxEntries": 42, # Maximum number of values allowed for the field type.
       },
-      "maxChoices": 42, # The max number of choices.
+      "maxChoices": 42, # Maximum number of choices.
       "maxDeletedChoices": 42, # Maximum number of deleted choices.
       "maxDisplayNameLength": 42, # Maximum length for display name.
-      "maxIdLength": 42, # Maximum ID length for a selection options.
+      "maxIdLength": 42, # Maximum ID length for a selection option.
     },
-    "textLimits": { # Limits for text Field type. # The relevant limits for the specified Field.Type. Text Field limits.
-      "maxLength": 42, # Maximum length allowed for a text Field type.
-      "minLength": 42, # Minimum length allowed for a text Field type.
+    "textLimits": { # Limits for text field type. # The relevant limits for the specified Field.Type. Text field limits.
+      "maxLength": 42, # Maximum length allowed for a text field type.
+      "minLength": 42, # Minimum length allowed for a text field type.
     },
-    "userLimits": { # Limits for Field.Type.USER. # User Field limits.
-      "listLimits": { # Limits for list-variant of a Field type. # Limits for list-variant of a Field type.
-        "maxEntries": 42, # Maximum number of values allowed for the Field type.
+    "userLimits": { # Limits for Field.Type.USER. # User field limits.
+      "listLimits": { # Limits for list-variant of a field type. # Limits for list-variant of a field type.
+        "maxEntries": 42, # Maximum number of values allowed for the field type.
       },
     },
   },
-  "maxDeletedFields": 42, # The maximum number of published Fields that can be deleted.
+  "maxDeletedFields": 42, # The maximum number of published fields that can be deleted.
   "maxDescriptionLength": 42, # The maximum number of characters allowed for the description.
   "maxDraftRevisions": 42, # The maximum number of draft revisions that will be kept before deleting old drafts.
-  "maxFields": 42, # The maximum number of Fields allowed within the label.
+  "maxFields": 42, # The maximum number of fields allowed within the label.
   "maxTitleLength": 42, # The maximum number of characters allowed for the title.
   "name": "A String", # Resource name.
 }

diff --git a/docs/dyn/drivelabels_v2beta.users.html b/docs/dyn/drivelabels_v2beta.users.html
index 33bae6d363b..81c8fcd0513 100644
--- a/docs/dyn/drivelabels_v2beta.users.html
+++ b/docs/dyn/drivelabels_v2beta.users.html
@@ -92,7 +92,7 @@ 
Method Details

 
 Args:
   name: string, Required. The resource name of the user. Only "users/me/capabilities" is supported. (required)
-  customer: string, The customer to scope this request to. For example: "customers/abcd1234". If unset, will return settings within the current customer.
+  customer: string, The customer to scope this request to. For example: `customers/abcd1234`. If unset, it will return settings within the current customer.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -104,8 +104,8 @@ 
Method Details

     { # The capabilities of a user.
   "canAccessLabelManager": True or False, # Output only. Whether the user is allowed access to the label manager.
   "canAdministrateLabels": True or False, # Output only. Whether the user is an administrator for the shared labels feature.
-  "canCreateAdminLabels": True or False, # Output only. Whether the user is allowed to create new admin labels.
-  "canCreateSharedLabels": True or False, # Output only. Whether the user is allowed to create new shared labels.
+  "canCreateAdminLabels": True or False, # Output only. Whether the user is allowed to create admin labels.
+  "canCreateSharedLabels": True or False, # Output only. Whether the user is allowed to create shared labels.
   "name": "A String", # Output only. Resource name for the user capabilities.
 }

 

diff --git a/docs/dyn/eventarc_v1.projects.locations.channels.html b/docs/dyn/eventarc_v1.projects.locations.channels.html
index c81f8bed936..2eee24112c8 100644
--- a/docs/dyn/eventarc_v1.projects.locations.channels.html
+++ b/docs/dyn/eventarc_v1.projects.locations.channels.html
@@ -122,7 +122,7 @@ 
Method Details

 { # A representation of the Channel resource. A Channel is a resource on which event providers publish their events. The published events are delivered through the transport associated with the channel. Note that a channel is associated with exactly one event provider.
   "activationToken": "A String", # Output only. The activation token for the channel. The token must be used by the provider to register the channel for publishing.
   "createTime": "A String", # Output only. The creation time.
-  "cryptoKeyName": "A String", # Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
+  "cryptoKeyName": "A String", # Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
   "labels": { # Optional. Resource labels.
     "a_key": "A String",
   },
@@ -219,7 +219,7 @@ 
Method Details

     { # A representation of the Channel resource. A Channel is a resource on which event providers publish their events. The published events are delivered through the transport associated with the channel. Note that a channel is associated with exactly one event provider.
   "activationToken": "A String", # Output only. The activation token for the channel. The token must be used by the provider to register the channel for publishing.
   "createTime": "A String", # Output only. The creation time.
-  "cryptoKeyName": "A String", # Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
+  "cryptoKeyName": "A String", # Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
   "labels": { # Optional. Resource labels.
     "a_key": "A String",
   },
@@ -303,7 +303,7 @@ 
Method Details

     { # A representation of the Channel resource. A Channel is a resource on which event providers publish their events. The published events are delivered through the transport associated with the channel. Note that a channel is associated with exactly one event provider.
       "activationToken": "A String", # Output only. The activation token for the channel. The token must be used by the provider to register the channel for publishing.
       "createTime": "A String", # Output only. The creation time.
-      "cryptoKeyName": "A String", # Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
+      "cryptoKeyName": "A String", # Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
       "labels": { # Optional. Resource labels.
         "a_key": "A String",
       },
@@ -349,7 +349,7 @@ 
Method Details

 { # A representation of the Channel resource. A Channel is a resource on which event providers publish their events. The published events are delivered through the transport associated with the channel. Note that a channel is associated with exactly one event provider.
   "activationToken": "A String", # Output only. The activation token for the channel. The token must be used by the provider to register the channel for publishing.
   "createTime": "A String", # Output only. The creation time.
-  "cryptoKeyName": "A String", # Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
+  "cryptoKeyName": "A String", # Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
   "labels": { # Optional. Resource labels.
     "a_key": "A String",
   },
diff --git a/docs/dyn/monitoring_v3.projects.alertPolicies.html b/docs/dyn/monitoring_v3.projects.alertPolicies.html
index b687170f390..372d8e76ebb 100644
--- a/docs/dyn/monitoring_v3.projects.alertPolicies.html
+++ b/docs/dyn/monitoring_v3.projects.alertPolicies.html
@@ -142,7 +142,7 @@ 
Method Details

             "perSeriesAligner": "A String", # An Aligner describes how to bring the data points in a single time series into temporal alignment. Except for ALIGN_NONE, all alignments cause all the data points in an alignment_period to be mathematically grouped together, resulting in a single data point for each alignment_period with end timestamp at the end of the period.Not all alignment operations may be applied to all time series. The valid choices depend on the metric_kind and value_type of the original time series. Alignment can change the metric_kind or the value_type of the time series.Time series data must be aligned in order to perform cross-time series reduction. If cross_series_reducer is specified, then per_series_aligner must be specified and not equal to ALIGN_NONE and alignment_period must be specified; otherwise, an error is returned.
           },
         ],
-        "duration": "A String", # The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned. The Duration.nanos field is ignored.
+        "duration": "A String", # Required. The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned.
         "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
         "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations.
           "count": 42, # The absolute number of time series that must fail the predicate for the condition to be triggered.
@@ -156,7 +156,7 @@ 
Method Details

         },
       },
       "conditionMonitoringQueryLanguage": { # A condition type that allows alerting policies to be defined using Monitoring Query Language (https://cloud.google.com/monitoring/mql). # A condition that uses the Monitoring Query Language to define alerts.
-        "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+        "duration": "A String", # Optional. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly. The default value is zero.
         "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving.
         "query": "A String", # Monitoring Query Language (https://cloud.google.com/monitoring/mql) query that outputs a boolean stream.
         "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations, or by the ratio, if denominator_filter and denominator_aggregations are specified.
@@ -224,7 +224,7 @@ 
Method Details

           },
         ],
         "denominatorFilter": "A String", # A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies a time series that should be used as the denominator of a ratio that will be compared with the threshold. If a denominator_filter is specified, the time series specified by the filter field will be used as the numerator.The filter must specify the metric type and optionally may contain restrictions on resource type, resource labels, and metric labels. This field may not exceed 2048 Unicode characters in length.
-        "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+        "duration": "A String", # Required. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
         "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving. To use this control, the value of the duration field must be greater than or equal to 60 seconds.
         "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
         "forecastOptions": { # Options used when forecasting the time series and testing the predicted value against the threshold. # When this field is present, the MetricThreshold condition forecasts whether the time series is predicted to violate the threshold within the forecast_horizon. When this field is not set, the MetricThreshold tests the current value of the timeseries against the threshold.
@@ -320,7 +320,7 @@ 
Method Details

             "perSeriesAligner": "A String", # An Aligner describes how to bring the data points in a single time series into temporal alignment. Except for ALIGN_NONE, all alignments cause all the data points in an alignment_period to be mathematically grouped together, resulting in a single data point for each alignment_period with end timestamp at the end of the period.Not all alignment operations may be applied to all time series. The valid choices depend on the metric_kind and value_type of the original time series. Alignment can change the metric_kind or the value_type of the time series.Time series data must be aligned in order to perform cross-time series reduction. If cross_series_reducer is specified, then per_series_aligner must be specified and not equal to ALIGN_NONE and alignment_period must be specified; otherwise, an error is returned.
           },
         ],
-        "duration": "A String", # The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned. The Duration.nanos field is ignored.
+        "duration": "A String", # Required. The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned.
         "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
         "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations.
           "count": 42, # The absolute number of time series that must fail the predicate for the condition to be triggered.
@@ -334,7 +334,7 @@ 
Method Details

         },
       },
       "conditionMonitoringQueryLanguage": { # A condition type that allows alerting policies to be defined using Monitoring Query Language (https://cloud.google.com/monitoring/mql). # A condition that uses the Monitoring Query Language to define alerts.
-        "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+        "duration": "A String", # Optional. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly. The default value is zero.
         "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving.
         "query": "A String", # Monitoring Query Language (https://cloud.google.com/monitoring/mql) query that outputs a boolean stream.
         "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations, or by the ratio, if denominator_filter and denominator_aggregations are specified.
@@ -402,7 +402,7 @@ 
Method Details

           },
         ],
         "denominatorFilter": "A String", # A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies a time series that should be used as the denominator of a ratio that will be compared with the threshold. If a denominator_filter is specified, the time series specified by the filter field will be used as the numerator.The filter must specify the metric type and optionally may contain restrictions on resource type, resource labels, and metric labels. This field may not exceed 2048 Unicode characters in length.
-        "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+        "duration": "A String", # Required. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
         "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving. To use this control, the value of the duration field must be greater than or equal to 60 seconds.
         "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
         "forecastOptions": { # Options used when forecasting the time series and testing the predicted value against the threshold. # When this field is present, the MetricThreshold condition forecasts whether the time series is predicted to violate the threshold within the forecast_horizon. When this field is not set, the MetricThreshold tests the current value of the timeseries against the threshold.
@@ -523,7 +523,7 @@ 
Method Details

             "perSeriesAligner": "A String", # An Aligner describes how to bring the data points in a single time series into temporal alignment. Except for ALIGN_NONE, all alignments cause all the data points in an alignment_period to be mathematically grouped together, resulting in a single data point for each alignment_period with end timestamp at the end of the period.Not all alignment operations may be applied to all time series. The valid choices depend on the metric_kind and value_type of the original time series. Alignment can change the metric_kind or the value_type of the time series.Time series data must be aligned in order to perform cross-time series reduction. If cross_series_reducer is specified, then per_series_aligner must be specified and not equal to ALIGN_NONE and alignment_period must be specified; otherwise, an error is returned.
           },
         ],
-        "duration": "A String", # The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned. The Duration.nanos field is ignored.
+        "duration": "A String", # Required. The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned.
         "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
         "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations.
           "count": 42, # The absolute number of time series that must fail the predicate for the condition to be triggered.
@@ -537,7 +537,7 @@ 
Method Details

         },
       },
       "conditionMonitoringQueryLanguage": { # A condition type that allows alerting policies to be defined using Monitoring Query Language (https://cloud.google.com/monitoring/mql). # A condition that uses the Monitoring Query Language to define alerts.
-        "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+        "duration": "A String", # Optional. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly. The default value is zero.
         "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving.
         "query": "A String", # Monitoring Query Language (https://cloud.google.com/monitoring/mql) query that outputs a boolean stream.
         "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations, or by the ratio, if denominator_filter and denominator_aggregations are specified.
@@ -605,7 +605,7 @@ 
Method Details

           },
         ],
         "denominatorFilter": "A String", # A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies a time series that should be used as the denominator of a ratio that will be compared with the threshold. If a denominator_filter is specified, the time series specified by the filter field will be used as the numerator.The filter must specify the metric type and optionally may contain restrictions on resource type, resource labels, and metric labels. This field may not exceed 2048 Unicode characters in length.
-        "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+        "duration": "A String", # Required. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
         "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving. To use this control, the value of the duration field must be greater than or equal to 60 seconds.
         "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
         "forecastOptions": { # Options used when forecasting the time series and testing the predicted value against the threshold. # When this field is present, the MetricThreshold condition forecasts whether the time series is predicted to violate the threshold within the forecast_horizon. When this field is not set, the MetricThreshold tests the current value of the timeseries against the threshold.
@@ -714,7 +714,7 @@ 
Method Details

                 "perSeriesAligner": "A String", # An Aligner describes how to bring the data points in a single time series into temporal alignment. Except for ALIGN_NONE, all alignments cause all the data points in an alignment_period to be mathematically grouped together, resulting in a single data point for each alignment_period with end timestamp at the end of the period.Not all alignment operations may be applied to all time series. The valid choices depend on the metric_kind and value_type of the original time series. Alignment can change the metric_kind or the value_type of the time series.Time series data must be aligned in order to perform cross-time series reduction. If cross_series_reducer is specified, then per_series_aligner must be specified and not equal to ALIGN_NONE and alignment_period must be specified; otherwise, an error is returned.
               },
             ],
-            "duration": "A String", # The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned. The Duration.nanos field is ignored.
+            "duration": "A String", # Required. The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned.
             "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
             "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations.
               "count": 42, # The absolute number of time series that must fail the predicate for the condition to be triggered.
@@ -728,7 +728,7 @@ 
Method Details

             },
           },
           "conditionMonitoringQueryLanguage": { # A condition type that allows alerting policies to be defined using Monitoring Query Language (https://cloud.google.com/monitoring/mql). # A condition that uses the Monitoring Query Language to define alerts.
-            "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+            "duration": "A String", # Optional. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly. The default value is zero.
             "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving.
             "query": "A String", # Monitoring Query Language (https://cloud.google.com/monitoring/mql) query that outputs a boolean stream.
             "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations, or by the ratio, if denominator_filter and denominator_aggregations are specified.
@@ -796,7 +796,7 @@ 
Method Details

               },
             ],
             "denominatorFilter": "A String", # A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies a time series that should be used as the denominator of a ratio that will be compared with the threshold. If a denominator_filter is specified, the time series specified by the filter field will be used as the numerator.The filter must specify the metric type and optionally may contain restrictions on resource type, resource labels, and metric labels. This field may not exceed 2048 Unicode characters in length.
-            "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+            "duration": "A String", # Required. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
             "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving. To use this control, the value of the duration field must be greater than or equal to 60 seconds.
             "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
             "forecastOptions": { # Options used when forecasting the time series and testing the predicted value against the threshold. # When this field is present, the MetricThreshold condition forecasts whether the time series is predicted to violate the threshold within the forecast_horizon. When this field is not set, the MetricThreshold tests the current value of the timeseries against the threshold.
@@ -912,7 +912,7 @@ 
Method Details

             "perSeriesAligner": "A String", # An Aligner describes how to bring the data points in a single time series into temporal alignment. Except for ALIGN_NONE, all alignments cause all the data points in an alignment_period to be mathematically grouped together, resulting in a single data point for each alignment_period with end timestamp at the end of the period.Not all alignment operations may be applied to all time series. The valid choices depend on the metric_kind and value_type of the original time series. Alignment can change the metric_kind or the value_type of the time series.Time series data must be aligned in order to perform cross-time series reduction. If cross_series_reducer is specified, then per_series_aligner must be specified and not equal to ALIGN_NONE and alignment_period must be specified; otherwise, an error is returned.
           },
         ],
-        "duration": "A String", # The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned. The Duration.nanos field is ignored.
+        "duration": "A String", # Required. The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned.
         "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
         "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations.
           "count": 42, # The absolute number of time series that must fail the predicate for the condition to be triggered.
@@ -926,7 +926,7 @@ 
Method Details

         },
       },
       "conditionMonitoringQueryLanguage": { # A condition type that allows alerting policies to be defined using Monitoring Query Language (https://cloud.google.com/monitoring/mql). # A condition that uses the Monitoring Query Language to define alerts.
-        "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+        "duration": "A String", # Optional. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly. The default value is zero.
         "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving.
         "query": "A String", # Monitoring Query Language (https://cloud.google.com/monitoring/mql) query that outputs a boolean stream.
         "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations, or by the ratio, if denominator_filter and denominator_aggregations are specified.
@@ -994,7 +994,7 @@ 
Method Details

           },
         ],
         "denominatorFilter": "A String", # A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies a time series that should be used as the denominator of a ratio that will be compared with the threshold. If a denominator_filter is specified, the time series specified by the filter field will be used as the numerator.The filter must specify the metric type and optionally may contain restrictions on resource type, resource labels, and metric labels. This field may not exceed 2048 Unicode characters in length.
-        "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+        "duration": "A String", # Required. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
         "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving. To use this control, the value of the duration field must be greater than or equal to 60 seconds.
         "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
         "forecastOptions": { # Options used when forecasting the time series and testing the predicted value against the threshold. # When this field is present, the MetricThreshold condition forecasts whether the time series is predicted to violate the threshold within the forecast_horizon. When this field is not set, the MetricThreshold tests the current value of the timeseries against the threshold.
@@ -1091,7 +1091,7 @@ 
Method Details

             "perSeriesAligner": "A String", # An Aligner describes how to bring the data points in a single time series into temporal alignment. Except for ALIGN_NONE, all alignments cause all the data points in an alignment_period to be mathematically grouped together, resulting in a single data point for each alignment_period with end timestamp at the end of the period.Not all alignment operations may be applied to all time series. The valid choices depend on the metric_kind and value_type of the original time series. Alignment can change the metric_kind or the value_type of the time series.Time series data must be aligned in order to perform cross-time series reduction. If cross_series_reducer is specified, then per_series_aligner must be specified and not equal to ALIGN_NONE and alignment_period must be specified; otherwise, an error is returned.
           },
         ],
-        "duration": "A String", # The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned. The Duration.nanos field is ignored.
+        "duration": "A String", # Required. The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned.
         "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
         "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations.
           "count": 42, # The absolute number of time series that must fail the predicate for the condition to be triggered.
@@ -1105,7 +1105,7 @@ 
Method Details

         },
       },
       "conditionMonitoringQueryLanguage": { # A condition type that allows alerting policies to be defined using Monitoring Query Language (https://cloud.google.com/monitoring/mql). # A condition that uses the Monitoring Query Language to define alerts.
-        "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+        "duration": "A String", # Optional. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly. The default value is zero.
         "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving.
         "query": "A String", # Monitoring Query Language (https://cloud.google.com/monitoring/mql) query that outputs a boolean stream.
         "trigger": { # Specifies how many time series must fail a predicate to trigger a condition. If not specified, then a {count: 1} trigger is used. # The number/percent of time series for which the comparison must hold in order for the condition to trigger. If unspecified, then the condition will trigger if the comparison is true for any of the time series that have been identified by filter and aggregations, or by the ratio, if denominator_filter and denominator_aggregations are specified.
@@ -1173,7 +1173,7 @@ 
Method Details

           },
         ],
         "denominatorFilter": "A String", # A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies a time series that should be used as the denominator of a ratio that will be compared with the threshold. If a denominator_filter is specified, the time series specified by the filter field will be used as the numerator.The filter must specify the metric type and optionally may contain restrictions on resource type, resource labels, and metric labels. This field may not exceed 2048 Unicode characters in length.
-        "duration": "A String", # The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
+        "duration": "A String", # Required. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.
         "evaluationMissingData": "A String", # A condition control that determines how metric-threshold conditions are evaluated when data stops arriving. To use this control, the value of the duration field must be greater than or equal to 60 seconds.
         "filter": "A String", # Required. A filter (https://cloud.google.com/monitoring/api/v3/filters) that identifies which time series should be compared with the threshold.The filter is similar to the one that is specified in the ListTimeSeries request (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that call is useful to verify the time series that will be retrieved / processed). The filter must specify the metric type and the resource type. Optionally, it can specify resource labels and metric labels. This field must not exceed 2048 Unicode characters in length.
         "forecastOptions": { # Options used when forecasting the time series and testing the predicted value against the threshold. # When this field is present, the MetricThreshold condition forecasts whether the time series is predicted to violate the threshold within the forecast_horizon. When this field is not set, the MetricThreshold tests the current value of the timeseries against the threshold.
diff --git a/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html b/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html
index ea393d5a910..3f233c4f801 100644
--- a/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html
+++ b/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html
@@ -137,13 +137,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -155,7 +155,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -165,7 +165,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -175,13 +175,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -193,7 +193,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -203,7 +203,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -216,7 +216,7 @@ 
Method Details

         "notOperations": [ # Optional. Describes the negated properties of the targets of a request. Matches requests for operations that do not match the criteria specified in this field. At least one of operations or notOperations must be specified.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -229,7 +229,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -238,10 +238,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
@@ -255,7 +255,7 @@ 
Method Details

         "operations": [ # Optional. Describes properties of one or more targets of a request. At least one of operations or notOperations must be specified. Limited to 1 operation. A match occurs when ANY operation (in operations or notOperations) matches. Within an operation, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -268,7 +268,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -277,10 +277,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
@@ -407,13 +407,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -425,7 +425,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -435,7 +435,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -445,13 +445,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -463,7 +463,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -473,7 +473,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -486,7 +486,7 @@ 
Method Details

         "notOperations": [ # Optional. Describes the negated properties of the targets of a request. Matches requests for operations that do not match the criteria specified in this field. At least one of operations or notOperations must be specified.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -499,7 +499,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -508,10 +508,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
@@ -525,7 +525,7 @@ 
Method Details

         "operations": [ # Optional. Describes properties of one or more targets of a request. At least one of operations or notOperations must be specified. Limited to 1 operation. A match occurs when ANY operation (in operations or notOperations) matches. Within an operation, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -538,7 +538,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -547,10 +547,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
@@ -665,13 +665,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
                   { # 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.
+                "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
                   { # 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``
@@ -683,7 +683,7 @@ 
Method Details

                     "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.
+                "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
                   { # 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.
                       "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``
@@ -693,7 +693,7 @@ 
Method Details

                       "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``
                     },
                     "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                      "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                      "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                         "A String",
                       ],
                     },
@@ -703,13 +703,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
                   { # 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.
+                "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
                   { # 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``
@@ -721,7 +721,7 @@ 
Method Details

                     "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.
+                "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
                   { # 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.
                       "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``
@@ -731,7 +731,7 @@ 
Method Details

                       "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``
                     },
                     "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                      "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                      "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                         "A String",
                       ],
                     },
@@ -744,7 +744,7 @@ 
Method Details

             "notOperations": [ # Optional. Describes the negated properties of the targets of a request. Matches requests for operations that do not match the criteria specified in this field. At least one of operations or notOperations must be specified.
               { # Describes properties of one or more targets of a request.
                 "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-                  "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+                  "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                     { # Determines how a HTTP header should be matched.
                       "name": "A String", # Optional. Specifies the name of the header in the request.
                       "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -757,7 +757,7 @@ 
Method Details

                     },
                   ],
                 },
-                "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+                "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
                   { # Determines how a string value should be matched.
                     "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``.
@@ -766,10 +766,10 @@ 
Method Details

                     "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``
                   },
                 ],
-                "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+                "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
                   "A String",
                 ],
-                "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+                "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
                   { # Determines how a string value should be matched.
                     "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``.
@@ -783,7 +783,7 @@ 
Method Details

             "operations": [ # Optional. Describes properties of one or more targets of a request. At least one of operations or notOperations must be specified. Limited to 1 operation. A match occurs when ANY operation (in operations or notOperations) matches. Within an operation, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches.
               { # Describes properties of one or more targets of a request.
                 "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-                  "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+                  "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                     { # Determines how a HTTP header should be matched.
                       "name": "A String", # Optional. Specifies the name of the header in the request.
                       "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -796,7 +796,7 @@ 
Method Details

                     },
                   ],
                 },
-                "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+                "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
                   { # Determines how a string value should be matched.
                     "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``.
@@ -805,10 +805,10 @@ 
Method Details

                     "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``
                   },
                 ],
-                "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+                "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
                   "A String",
                 ],
-                "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+                "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
                   { # Determines how a string value should be matched.
                     "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``.
@@ -884,13 +884,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -902,7 +902,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -912,7 +912,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -922,13 +922,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -940,7 +940,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -950,7 +950,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -963,7 +963,7 @@ 
Method Details

         "notOperations": [ # Optional. Describes the negated properties of the targets of a request. Matches requests for operations that do not match the criteria specified in this field. At least one of operations or notOperations must be specified.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -976,7 +976,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -985,10 +985,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
@@ -1002,7 +1002,7 @@ 
Method Details

         "operations": [ # Optional. Describes properties of one or more targets of a request. At least one of operations or notOperations must be specified. Limited to 1 operation. A match occurs when ANY operation (in operations or notOperations) matches. Within an operation, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -1015,7 +1015,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -1024,10 +1024,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.authzPolicies.html b/docs/dyn/networksecurity_v1beta1.projects.locations.authzPolicies.html
index ae553e4d7ba..5f150c671d3 100644
--- a/docs/dyn/networksecurity_v1beta1.projects.locations.authzPolicies.html
+++ b/docs/dyn/networksecurity_v1beta1.projects.locations.authzPolicies.html
@@ -137,13 +137,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -155,7 +155,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -165,7 +165,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -175,13 +175,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -193,7 +193,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -203,7 +203,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -216,7 +216,7 @@ 
Method Details

         "notOperations": [ # Optional. Describes the negated properties of the targets of a request. Matches requests for operations that do not match the criteria specified in this field. At least one of operations or notOperations must be specified.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -229,7 +229,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -238,10 +238,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
@@ -255,7 +255,7 @@ 
Method Details

         "operations": [ # Optional. Describes properties of one or more targets of a request. At least one of operations or notOperations must be specified. Limited to 1 operation. A match occurs when ANY operation (in operations or notOperations) matches. Within an operation, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -268,7 +268,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -277,10 +277,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
@@ -407,13 +407,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -425,7 +425,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -435,7 +435,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -445,13 +445,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -463,7 +463,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -473,7 +473,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -486,7 +486,7 @@ 
Method Details

         "notOperations": [ # Optional. Describes the negated properties of the targets of a request. Matches requests for operations that do not match the criteria specified in this field. At least one of operations or notOperations must be specified.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -499,7 +499,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -508,10 +508,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
@@ -525,7 +525,7 @@ 
Method Details

         "operations": [ # Optional. Describes properties of one or more targets of a request. At least one of operations or notOperations must be specified. Limited to 1 operation. A match occurs when ANY operation (in operations or notOperations) matches. Within an operation, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -538,7 +538,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -547,10 +547,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
@@ -665,13 +665,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
                   { # 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.
+                "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
                   { # 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``
@@ -683,7 +683,7 @@ 
Method Details

                     "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.
+                "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
                   { # 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.
                       "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``
@@ -693,7 +693,7 @@ 
Method Details

                       "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``
                     },
                     "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                      "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                      "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                         "A String",
                       ],
                     },
@@ -703,13 +703,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
                   { # 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.
+                "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
                   { # 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``
@@ -721,7 +721,7 @@ 
Method Details

                     "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.
+                "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
                   { # 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.
                       "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``
@@ -731,7 +731,7 @@ 
Method Details

                       "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``
                     },
                     "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                      "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                      "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                         "A String",
                       ],
                     },
@@ -744,7 +744,7 @@ 
Method Details

             "notOperations": [ # Optional. Describes the negated properties of the targets of a request. Matches requests for operations that do not match the criteria specified in this field. At least one of operations or notOperations must be specified.
               { # Describes properties of one or more targets of a request.
                 "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-                  "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+                  "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                     { # Determines how a HTTP header should be matched.
                       "name": "A String", # Optional. Specifies the name of the header in the request.
                       "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -757,7 +757,7 @@ 
Method Details

                     },
                   ],
                 },
-                "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+                "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
                   { # Determines how a string value should be matched.
                     "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``.
@@ -766,10 +766,10 @@ 
Method Details

                     "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``
                   },
                 ],
-                "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+                "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
                   "A String",
                 ],
-                "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+                "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
                   { # Determines how a string value should be matched.
                     "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``.
@@ -783,7 +783,7 @@ 
Method Details

             "operations": [ # Optional. Describes properties of one or more targets of a request. At least one of operations or notOperations must be specified. Limited to 1 operation. A match occurs when ANY operation (in operations or notOperations) matches. Within an operation, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches.
               { # Describes properties of one or more targets of a request.
                 "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-                  "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+                  "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                     { # Determines how a HTTP header should be matched.
                       "name": "A String", # Optional. Specifies the name of the header in the request.
                       "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -796,7 +796,7 @@ 
Method Details

                     },
                   ],
                 },
-                "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+                "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
                   { # Determines how a string value should be matched.
                     "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``.
@@ -805,10 +805,10 @@ 
Method Details

                     "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``
                   },
                 ],
-                "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+                "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
                   "A String",
                 ],
-                "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+                "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
                   { # Determines how a string value should be matched.
                     "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``.
@@ -884,13 +884,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -902,7 +902,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -912,7 +912,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -922,13 +922,13 @@ 
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 IP addresses or IP address ranges to match against the source IP address of the 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 10 ip_blocks per Authorization Policy
               { # 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.
+            "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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.
               { # 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``
@@ -940,7 +940,7 @@ 
Method Details

                 "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.
+            "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.
               { # 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.
                   "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``
@@ -950,7 +950,7 @@ 
Method Details

                   "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``
                 },
                 "tagValueIdSet": { # Describes a set of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. # Optional. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request.
-                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.
+                  "ids": [ # Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.
                     "A String",
                   ],
                 },
@@ -963,7 +963,7 @@ 
Method Details

         "notOperations": [ # Optional. Describes the negated properties of the targets of a request. Matches requests for operations that do not match the criteria specified in this field. At least one of operations or notOperations must be specified.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -976,7 +976,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -985,10 +985,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
@@ -1002,7 +1002,7 @@ 
Method Details

         "operations": [ # Optional. Describes properties of one or more targets of a request. At least one of operations or notOperations must be specified. Limited to 1 operation. A match occurs when ANY operation (in operations or notOperations) matches. Within an operation, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches.
           { # Describes properties of one or more targets of a request.
             "headerSet": { # Describes a set of HTTP headers to match against. # Optional. A list of headers to match against in http header.
-              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+              "headers": [ # Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.
                 { # Determines how a HTTP header should be matched.
                   "name": "A String", # Optional. Specifies the name of the header in the request.
                   "value": { # Determines how a string value should be matched. # Optional. Specifies how the header match will be performed.
@@ -1015,7 +1015,7 @@ 
Method Details

                 },
               ],
             },
-            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.
+            "hosts": [ # Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.
               { # Determines how a string value should be matched.
                 "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``.
@@ -1024,10 +1024,10 @@ 
Method Details

                 "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``
               },
             ],
-            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.
+            "methods": [ # Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.
               "A String",
             ],
-            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
+            "paths": [ # Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.
               { # Determines how a string value should be matched.
                 "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``.
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html b/docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html
index 6814da19f21..6c99bf11a86 100644
--- a/docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html
+++ b/docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html
@@ -110,7 +110,7 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # Message describing DnsThreatDetector object
+{ # 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",
@@ -132,7 +132,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Message describing DnsThreatDetector object
+    { # 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",
@@ -178,7 +178,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Message describing DnsThreatDetector object
+    { # 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",
@@ -208,9 +208,9 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Message for response to listing DnsThreatDetectors
+    { # Message for response to listing DnsThreatDetectors.
   "dnsThreatDetectors": [ # The list of DnsThreatDetector resources.
-    { # Message describing DnsThreatDetector object
+    { # 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",
@@ -253,7 +253,7 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # Message describing DnsThreatDetector object
+{ # 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",
@@ -275,7 +275,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Message describing DnsThreatDetector object
+    { # 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",
diff --git a/docs/dyn/solar_v1.buildingInsights.html b/docs/dyn/solar_v1.buildingInsights.html
index 2a46c526f25..92f09bc2b46 100644
--- a/docs/dyn/solar_v1.buildingInsights.html
+++ b/docs/dyn/solar_v1.buildingInsights.html
@@ -103,7 +103,7 @@ 
Method Details

       HIGH - Solar data is derived from aerial imagery captured at low-altitude and processed at 0.1 m/pixel.
       MEDIUM - Solar data is derived from enhanced aerial imagery captured at high-altitude and processed at 0.25 m/pixel.
       LOW - Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.
-      BASE - Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel. **Note:** This enum is only available if `experiments=EXPANDED_COVERAGE` is set in the request. For more information, see [Expanded Coverage](https://developers.google.com/maps/documentation/solar/expanded-coverage).
+      BASE - Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/solar_v1.dataLayers.html b/docs/dyn/solar_v1.dataLayers.html
index e6b1b560431..46342488915 100644
--- a/docs/dyn/solar_v1.dataLayers.html
+++ b/docs/dyn/solar_v1.dataLayers.html
@@ -106,7 +106,7 @@ 
Method Details

       HIGH - Solar data is derived from aerial imagery captured at low-altitude and processed at 0.1 m/pixel.
       MEDIUM - Solar data is derived from enhanced aerial imagery captured at high-altitude and processed at 0.25 m/pixel.
       LOW - Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.
-      BASE - Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel. **Note:** This enum is only available if `experiments=EXPANDED_COVERAGE` is set in the request. For more information, see [Expanded Coverage](https://developers.google.com/maps/documentation/solar/expanded-coverage).
+      BASE - Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.
   view: string, Optional. The desired subset of the data to return.
     Allowed values
       DATA_LAYER_VIEW_UNSPECIFIED - Equivalent to FULL.
diff --git a/docs/dyn/storagetransfer_v1.transferJobs.html b/docs/dyn/storagetransfer_v1.transferJobs.html
index 8443169081e..e73b82e805d 100644
--- a/docs/dyn/storagetransfer_v1.transferJobs.html
+++ b/docs/dyn/storagetransfer_v1.transferJobs.html
@@ -210,7 +210,7 @@ 
Method Details

   "serviceAccount": "A String", # Optional. The user-managed service account to which to delegate service agent permissions. You can grant Cloud Storage bucket permissions to this service account instead of to the Transfer Service service agent. Format is `projects/-/serviceAccounts/ACCOUNT_EMAIL_OR_UNIQUEID` Either the service account email (`SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com`) or the unique ID (`123456789012345678901`) are accepted in the string. The `-` wildcard character is required; replacing it with a project ID is invalid. See https://cloud.google.com//storage-transfer/docs/delegate-service-agent-permissions for required permissions.
   "status": "A String", # Status of the job. This value MUST be specified for `CreateTransferJobRequests`. **Note:** The effect of the new job status takes place during a subsequent job run. For example, if you change the job status from ENABLED to DISABLED, and an operation spawned by the transfer is running, the status change would not affect the current operation.
   "transferSpec": { # Configuration for running a transfer. # Transfer specification.
-    "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # An AWS S3 compatible data source.
+    "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # Optional. An AWS S3 compatible data source.
       "bucketName": "A String", # Required. Specifies the name of the bucket.
       "endpoint": "A String", # Required. Specifies the endpoint of the storage service.
       "path": "A String", # Specifies the root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
@@ -222,7 +222,7 @@ 
Method Details

         "requestModel": "A String", # Specifies the API request model used to call the storage service. When not specified, the default value of RequestModel REQUEST_MODEL_VIRTUAL_HOSTED_STYLE is used.
       },
     },
-    "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # An AWS S3 data source.
+    "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # Optional. An AWS S3 data source.
       "awsAccessKey": { # AWS access key (see [AWS Security Credentials](https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html)). For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Input only. AWS access key used to sign the API requests to the AWS S3 bucket. Permissions on the bucket must be granted to the access ID of the AWS access key. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
         "accessKeyId": "A String", # Required. AWS access key ID.
         "secretAccessKey": "A String", # Required. AWS secret access key. This field is not returned in RPC responses.
@@ -234,7 +234,7 @@ 
Method Details

       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
       "roleArn": "A String", # The Amazon Resource Name (ARN) of the role to support temporary credentials via `AssumeRoleWithWebIdentity`. For more information about ARNs, see [IAM ARNs](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns). When a role ARN is provided, Transfer Service fetches temporary credentials for the session using a `AssumeRoleWithWebIdentity` call for the provided role using the GoogleServiceAccount for this project.
     },
-    "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # An Azure Blob Storage data source.
+    "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # Optional. An Azure Blob Storage data source.
       "azureCredentials": { # Azure credentials For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Required. Input only. Credentials used to authenticate API requests to Azure. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
         "sasToken": "A String", # Required. Azure shared access signature (SAS). For more information about SAS, see [Grant limited access to Azure Storage resources using shared access signatures (SAS)](https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-overview).
       },
@@ -247,12 +247,12 @@ 
Method Details

       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
       "storageAccount": "A String", # Required. The name of the Azure Storage account.
     },
-    "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data sink.
+    "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data sink.
       "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
     },
-    "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data source.
+    "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data source.
       "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
@@ -262,10 +262,10 @@ 
Method Details

       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
     },
-    "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # An HDFS cluster data source.
+    "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # Optional. An HDFS cluster data source.
       "path": "A String", # Root path to transfer files.
     },
-    "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # An HTTP URL data source.
+    "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # Optional. An HTTP URL data source.
       "listUrl": "A String", # Required. The URL that points to the file that stores the object list entries. This file must allow public access. The URL is either an HTTP/HTTPS address (e.g. `https://example.com/urllist.tsv`) or a Cloud Storage path (e.g. `gs://my-bucket/urllist.tsv`).
     },
     "objectConditions": { # Conditions that determine which objects are transferred. Applies only to Cloud Data Sources such as S3, Azure, and Cloud Storage. The "last modification time" refers to the time of the last change to the object's content or metadata — specifically, this is the `updated` property of Cloud Storage objects, the `LastModified` field of S3 objects, and the `Last-Modified` header of Azure blobs. For S3 objects, the `LastModified` value is the time the object begins uploading. If the object meets your "last modification time" criteria, but has not finished uploading, the object is not transferred. See [Transfer from Amazon S3 to Cloud Storage](https://cloud.google.com/storage-transfer/docs/create-transfers/agentless/s3#transfer_options) for more information. Transfers with a PosixFilesystem source or destination don't support `ObjectConditions`. # Only objects that satisfy these object conditions are included in the set of data source and data sink objects. Object conditions based on objects' "last modification time" do not exclude objects in a data sink.
@@ -280,10 +280,10 @@ 
Method Details

       "maxTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred if a specific maximum time has elapsed since the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation`and the "last modification time" of the object is less than the value of max_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
       "minTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred until a specific minimum time has elapsed after the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation` and the "last modification time" of the object is equal to or greater than the value of min_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
     },
-    "posixDataSink": { # A POSIX filesystem resource. # A POSIX Filesystem data sink.
+    "posixDataSink": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data sink.
       "rootDirectory": "A String", # Root directory path to the filesystem.
     },
-    "posixDataSource": { # A POSIX filesystem resource. # A POSIX Filesystem data source.
+    "posixDataSource": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data source.
       "rootDirectory": "A String", # Root directory path to the filesystem.
     },
     "sinkAgentPoolName": "A String", # Specifies the agent pool name associated with the posix data sink. When unspecified, the default name is used.
@@ -417,7 +417,7 @@ 
Method Details

   "serviceAccount": "A String", # Optional. The user-managed service account to which to delegate service agent permissions. You can grant Cloud Storage bucket permissions to this service account instead of to the Transfer Service service agent. Format is `projects/-/serviceAccounts/ACCOUNT_EMAIL_OR_UNIQUEID` Either the service account email (`SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com`) or the unique ID (`123456789012345678901`) are accepted in the string. The `-` wildcard character is required; replacing it with a project ID is invalid. See https://cloud.google.com//storage-transfer/docs/delegate-service-agent-permissions for required permissions.
   "status": "A String", # Status of the job. This value MUST be specified for `CreateTransferJobRequests`. **Note:** The effect of the new job status takes place during a subsequent job run. For example, if you change the job status from ENABLED to DISABLED, and an operation spawned by the transfer is running, the status change would not affect the current operation.
   "transferSpec": { # Configuration for running a transfer. # Transfer specification.
-    "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # An AWS S3 compatible data source.
+    "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # Optional. An AWS S3 compatible data source.
       "bucketName": "A String", # Required. Specifies the name of the bucket.
       "endpoint": "A String", # Required. Specifies the endpoint of the storage service.
       "path": "A String", # Specifies the root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
@@ -429,7 +429,7 @@ 
Method Details

         "requestModel": "A String", # Specifies the API request model used to call the storage service. When not specified, the default value of RequestModel REQUEST_MODEL_VIRTUAL_HOSTED_STYLE is used.
       },
     },
-    "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # An AWS S3 data source.
+    "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # Optional. An AWS S3 data source.
       "awsAccessKey": { # AWS access key (see [AWS Security Credentials](https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html)). For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Input only. AWS access key used to sign the API requests to the AWS S3 bucket. Permissions on the bucket must be granted to the access ID of the AWS access key. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
         "accessKeyId": "A String", # Required. AWS access key ID.
         "secretAccessKey": "A String", # Required. AWS secret access key. This field is not returned in RPC responses.
@@ -441,7 +441,7 @@ 
Method Details

       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
       "roleArn": "A String", # The Amazon Resource Name (ARN) of the role to support temporary credentials via `AssumeRoleWithWebIdentity`. For more information about ARNs, see [IAM ARNs](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns). When a role ARN is provided, Transfer Service fetches temporary credentials for the session using a `AssumeRoleWithWebIdentity` call for the provided role using the GoogleServiceAccount for this project.
     },
-    "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # An Azure Blob Storage data source.
+    "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # Optional. An Azure Blob Storage data source.
       "azureCredentials": { # Azure credentials For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Required. Input only. Credentials used to authenticate API requests to Azure. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
         "sasToken": "A String", # Required. Azure shared access signature (SAS). For more information about SAS, see [Grant limited access to Azure Storage resources using shared access signatures (SAS)](https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-overview).
       },
@@ -454,12 +454,12 @@ 
Method Details

       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
       "storageAccount": "A String", # Required. The name of the Azure Storage account.
     },
-    "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data sink.
+    "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data sink.
       "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
     },
-    "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data source.
+    "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data source.
       "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
@@ -469,10 +469,10 @@ 
Method Details

       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
     },
-    "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # An HDFS cluster data source.
+    "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # Optional. An HDFS cluster data source.
       "path": "A String", # Root path to transfer files.
     },
-    "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # An HTTP URL data source.
+    "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # Optional. An HTTP URL data source.
       "listUrl": "A String", # Required. The URL that points to the file that stores the object list entries. This file must allow public access. The URL is either an HTTP/HTTPS address (e.g. `https://example.com/urllist.tsv`) or a Cloud Storage path (e.g. `gs://my-bucket/urllist.tsv`).
     },
     "objectConditions": { # Conditions that determine which objects are transferred. Applies only to Cloud Data Sources such as S3, Azure, and Cloud Storage. The "last modification time" refers to the time of the last change to the object's content or metadata — specifically, this is the `updated` property of Cloud Storage objects, the `LastModified` field of S3 objects, and the `Last-Modified` header of Azure blobs. For S3 objects, the `LastModified` value is the time the object begins uploading. If the object meets your "last modification time" criteria, but has not finished uploading, the object is not transferred. See [Transfer from Amazon S3 to Cloud Storage](https://cloud.google.com/storage-transfer/docs/create-transfers/agentless/s3#transfer_options) for more information. Transfers with a PosixFilesystem source or destination don't support `ObjectConditions`. # Only objects that satisfy these object conditions are included in the set of data source and data sink objects. Object conditions based on objects' "last modification time" do not exclude objects in a data sink.
@@ -487,10 +487,10 @@ 
Method Details

       "maxTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred if a specific maximum time has elapsed since the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation`and the "last modification time" of the object is less than the value of max_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
       "minTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred until a specific minimum time has elapsed after the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation` and the "last modification time" of the object is equal to or greater than the value of min_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
     },
-    "posixDataSink": { # A POSIX filesystem resource. # A POSIX Filesystem data sink.
+    "posixDataSink": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data sink.
       "rootDirectory": "A String", # Root directory path to the filesystem.
     },
-    "posixDataSource": { # A POSIX filesystem resource. # A POSIX Filesystem data source.
+    "posixDataSource": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data source.
       "rootDirectory": "A String", # Root directory path to the filesystem.
     },
     "sinkAgentPoolName": "A String", # Specifies the agent pool name associated with the posix data sink. When unspecified, the default name is used.
@@ -651,7 +651,7 @@ 
Method Details

   "serviceAccount": "A String", # Optional. The user-managed service account to which to delegate service agent permissions. You can grant Cloud Storage bucket permissions to this service account instead of to the Transfer Service service agent. Format is `projects/-/serviceAccounts/ACCOUNT_EMAIL_OR_UNIQUEID` Either the service account email (`SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com`) or the unique ID (`123456789012345678901`) are accepted in the string. The `-` wildcard character is required; replacing it with a project ID is invalid. See https://cloud.google.com//storage-transfer/docs/delegate-service-agent-permissions for required permissions.
   "status": "A String", # Status of the job. This value MUST be specified for `CreateTransferJobRequests`. **Note:** The effect of the new job status takes place during a subsequent job run. For example, if you change the job status from ENABLED to DISABLED, and an operation spawned by the transfer is running, the status change would not affect the current operation.
   "transferSpec": { # Configuration for running a transfer. # Transfer specification.
-    "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # An AWS S3 compatible data source.
+    "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # Optional. An AWS S3 compatible data source.
       "bucketName": "A String", # Required. Specifies the name of the bucket.
       "endpoint": "A String", # Required. Specifies the endpoint of the storage service.
       "path": "A String", # Specifies the root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
@@ -663,7 +663,7 @@ 
Method Details

         "requestModel": "A String", # Specifies the API request model used to call the storage service. When not specified, the default value of RequestModel REQUEST_MODEL_VIRTUAL_HOSTED_STYLE is used.
       },
     },
-    "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # An AWS S3 data source.
+    "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # Optional. An AWS S3 data source.
       "awsAccessKey": { # AWS access key (see [AWS Security Credentials](https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html)). For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Input only. AWS access key used to sign the API requests to the AWS S3 bucket. Permissions on the bucket must be granted to the access ID of the AWS access key. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
         "accessKeyId": "A String", # Required. AWS access key ID.
         "secretAccessKey": "A String", # Required. AWS secret access key. This field is not returned in RPC responses.
@@ -675,7 +675,7 @@ 
Method Details

       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
       "roleArn": "A String", # The Amazon Resource Name (ARN) of the role to support temporary credentials via `AssumeRoleWithWebIdentity`. For more information about ARNs, see [IAM ARNs](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns). When a role ARN is provided, Transfer Service fetches temporary credentials for the session using a `AssumeRoleWithWebIdentity` call for the provided role using the GoogleServiceAccount for this project.
     },
-    "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # An Azure Blob Storage data source.
+    "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # Optional. An Azure Blob Storage data source.
       "azureCredentials": { # Azure credentials For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Required. Input only. Credentials used to authenticate API requests to Azure. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
         "sasToken": "A String", # Required. Azure shared access signature (SAS). For more information about SAS, see [Grant limited access to Azure Storage resources using shared access signatures (SAS)](https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-overview).
       },
@@ -688,12 +688,12 @@ 
Method Details

       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
       "storageAccount": "A String", # Required. The name of the Azure Storage account.
     },
-    "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data sink.
+    "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data sink.
       "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
     },
-    "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data source.
+    "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data source.
       "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
@@ -703,10 +703,10 @@ 
Method Details

       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
     },
-    "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # An HDFS cluster data source.
+    "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # Optional. An HDFS cluster data source.
       "path": "A String", # Root path to transfer files.
     },
-    "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # An HTTP URL data source.
+    "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # Optional. An HTTP URL data source.
       "listUrl": "A String", # Required. The URL that points to the file that stores the object list entries. This file must allow public access. The URL is either an HTTP/HTTPS address (e.g. `https://example.com/urllist.tsv`) or a Cloud Storage path (e.g. `gs://my-bucket/urllist.tsv`).
     },
     "objectConditions": { # Conditions that determine which objects are transferred. Applies only to Cloud Data Sources such as S3, Azure, and Cloud Storage. The "last modification time" refers to the time of the last change to the object's content or metadata — specifically, this is the `updated` property of Cloud Storage objects, the `LastModified` field of S3 objects, and the `Last-Modified` header of Azure blobs. For S3 objects, the `LastModified` value is the time the object begins uploading. If the object meets your "last modification time" criteria, but has not finished uploading, the object is not transferred. See [Transfer from Amazon S3 to Cloud Storage](https://cloud.google.com/storage-transfer/docs/create-transfers/agentless/s3#transfer_options) for more information. Transfers with a PosixFilesystem source or destination don't support `ObjectConditions`. # Only objects that satisfy these object conditions are included in the set of data source and data sink objects. Object conditions based on objects' "last modification time" do not exclude objects in a data sink.
@@ -721,10 +721,10 @@ 
Method Details

       "maxTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred if a specific maximum time has elapsed since the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation`and the "last modification time" of the object is less than the value of max_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
       "minTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred until a specific minimum time has elapsed after the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation` and the "last modification time" of the object is equal to or greater than the value of min_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
     },
-    "posixDataSink": { # A POSIX filesystem resource. # A POSIX Filesystem data sink.
+    "posixDataSink": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data sink.
       "rootDirectory": "A String", # Root directory path to the filesystem.
     },
-    "posixDataSource": { # A POSIX filesystem resource. # A POSIX Filesystem data source.
+    "posixDataSource": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data source.
       "rootDirectory": "A String", # Root directory path to the filesystem.
     },
     "sinkAgentPoolName": "A String", # Specifies the agent pool name associated with the posix data sink. When unspecified, the default name is used.
@@ -870,7 +870,7 @@ 
Method Details

       "serviceAccount": "A String", # Optional. The user-managed service account to which to delegate service agent permissions. You can grant Cloud Storage bucket permissions to this service account instead of to the Transfer Service service agent. Format is `projects/-/serviceAccounts/ACCOUNT_EMAIL_OR_UNIQUEID` Either the service account email (`SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com`) or the unique ID (`123456789012345678901`) are accepted in the string. The `-` wildcard character is required; replacing it with a project ID is invalid. See https://cloud.google.com//storage-transfer/docs/delegate-service-agent-permissions for required permissions.
       "status": "A String", # Status of the job. This value MUST be specified for `CreateTransferJobRequests`. **Note:** The effect of the new job status takes place during a subsequent job run. For example, if you change the job status from ENABLED to DISABLED, and an operation spawned by the transfer is running, the status change would not affect the current operation.
       "transferSpec": { # Configuration for running a transfer. # Transfer specification.
-        "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # An AWS S3 compatible data source.
+        "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # Optional. An AWS S3 compatible data source.
           "bucketName": "A String", # Required. Specifies the name of the bucket.
           "endpoint": "A String", # Required. Specifies the endpoint of the storage service.
           "path": "A String", # Specifies the root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
@@ -882,7 +882,7 @@ 
Method Details

             "requestModel": "A String", # Specifies the API request model used to call the storage service. When not specified, the default value of RequestModel REQUEST_MODEL_VIRTUAL_HOSTED_STYLE is used.
           },
         },
-        "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # An AWS S3 data source.
+        "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # Optional. An AWS S3 data source.
           "awsAccessKey": { # AWS access key (see [AWS Security Credentials](https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html)). For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Input only. AWS access key used to sign the API requests to the AWS S3 bucket. Permissions on the bucket must be granted to the access ID of the AWS access key. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
             "accessKeyId": "A String", # Required. AWS access key ID.
             "secretAccessKey": "A String", # Required. AWS secret access key. This field is not returned in RPC responses.
@@ -894,7 +894,7 @@ 
Method Details

           "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
           "roleArn": "A String", # The Amazon Resource Name (ARN) of the role to support temporary credentials via `AssumeRoleWithWebIdentity`. For more information about ARNs, see [IAM ARNs](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns). When a role ARN is provided, Transfer Service fetches temporary credentials for the session using a `AssumeRoleWithWebIdentity` call for the provided role using the GoogleServiceAccount for this project.
         },
-        "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # An Azure Blob Storage data source.
+        "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # Optional. An Azure Blob Storage data source.
           "azureCredentials": { # Azure credentials For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Required. Input only. Credentials used to authenticate API requests to Azure. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
             "sasToken": "A String", # Required. Azure shared access signature (SAS). For more information about SAS, see [Grant limited access to Azure Storage resources using shared access signatures (SAS)](https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-overview).
           },
@@ -907,12 +907,12 @@ 
Method Details

           "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
           "storageAccount": "A String", # Required. The name of the Azure Storage account.
         },
-        "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data sink.
+        "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data sink.
           "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
           "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
           "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
         },
-        "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data source.
+        "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data source.
           "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
           "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
           "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
@@ -922,10 +922,10 @@ 
Method Details

           "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
           "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
         },
-        "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # An HDFS cluster data source.
+        "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # Optional. An HDFS cluster data source.
           "path": "A String", # Root path to transfer files.
         },
-        "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # An HTTP URL data source.
+        "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # Optional. An HTTP URL data source.
           "listUrl": "A String", # Required. The URL that points to the file that stores the object list entries. This file must allow public access. The URL is either an HTTP/HTTPS address (e.g. `https://example.com/urllist.tsv`) or a Cloud Storage path (e.g. `gs://my-bucket/urllist.tsv`).
         },
         "objectConditions": { # Conditions that determine which objects are transferred. Applies only to Cloud Data Sources such as S3, Azure, and Cloud Storage. The "last modification time" refers to the time of the last change to the object's content or metadata — specifically, this is the `updated` property of Cloud Storage objects, the `LastModified` field of S3 objects, and the `Last-Modified` header of Azure blobs. For S3 objects, the `LastModified` value is the time the object begins uploading. If the object meets your "last modification time" criteria, but has not finished uploading, the object is not transferred. See [Transfer from Amazon S3 to Cloud Storage](https://cloud.google.com/storage-transfer/docs/create-transfers/agentless/s3#transfer_options) for more information. Transfers with a PosixFilesystem source or destination don't support `ObjectConditions`. # Only objects that satisfy these object conditions are included in the set of data source and data sink objects. Object conditions based on objects' "last modification time" do not exclude objects in a data sink.
@@ -940,10 +940,10 @@ 
Method Details

           "maxTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred if a specific maximum time has elapsed since the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation`and the "last modification time" of the object is less than the value of max_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
           "minTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred until a specific minimum time has elapsed after the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation` and the "last modification time" of the object is equal to or greater than the value of min_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
         },
-        "posixDataSink": { # A POSIX filesystem resource. # A POSIX Filesystem data sink.
+        "posixDataSink": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data sink.
           "rootDirectory": "A String", # Root directory path to the filesystem.
         },
-        "posixDataSource": { # A POSIX filesystem resource. # A POSIX Filesystem data source.
+        "posixDataSource": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data source.
           "rootDirectory": "A String", # Root directory path to the filesystem.
         },
         "sinkAgentPoolName": "A String", # Specifies the agent pool name associated with the posix data sink. When unspecified, the default name is used.
@@ -1097,7 +1097,7 @@ 
Method Details

     "serviceAccount": "A String", # Optional. The user-managed service account to which to delegate service agent permissions. You can grant Cloud Storage bucket permissions to this service account instead of to the Transfer Service service agent. Format is `projects/-/serviceAccounts/ACCOUNT_EMAIL_OR_UNIQUEID` Either the service account email (`SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com`) or the unique ID (`123456789012345678901`) are accepted in the string. The `-` wildcard character is required; replacing it with a project ID is invalid. See https://cloud.google.com//storage-transfer/docs/delegate-service-agent-permissions for required permissions.
     "status": "A String", # Status of the job. This value MUST be specified for `CreateTransferJobRequests`. **Note:** The effect of the new job status takes place during a subsequent job run. For example, if you change the job status from ENABLED to DISABLED, and an operation spawned by the transfer is running, the status change would not affect the current operation.
     "transferSpec": { # Configuration for running a transfer. # Transfer specification.
-      "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # An AWS S3 compatible data source.
+      "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # Optional. An AWS S3 compatible data source.
         "bucketName": "A String", # Required. Specifies the name of the bucket.
         "endpoint": "A String", # Required. Specifies the endpoint of the storage service.
         "path": "A String", # Specifies the root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
@@ -1109,7 +1109,7 @@ 
Method Details

           "requestModel": "A String", # Specifies the API request model used to call the storage service. When not specified, the default value of RequestModel REQUEST_MODEL_VIRTUAL_HOSTED_STYLE is used.
         },
       },
-      "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # An AWS S3 data source.
+      "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # Optional. An AWS S3 data source.
         "awsAccessKey": { # AWS access key (see [AWS Security Credentials](https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html)). For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Input only. AWS access key used to sign the API requests to the AWS S3 bucket. Permissions on the bucket must be granted to the access ID of the AWS access key. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
           "accessKeyId": "A String", # Required. AWS access key ID.
           "secretAccessKey": "A String", # Required. AWS secret access key. This field is not returned in RPC responses.
@@ -1121,7 +1121,7 @@ 
Method Details

         "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
         "roleArn": "A String", # The Amazon Resource Name (ARN) of the role to support temporary credentials via `AssumeRoleWithWebIdentity`. For more information about ARNs, see [IAM ARNs](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns). When a role ARN is provided, Transfer Service fetches temporary credentials for the session using a `AssumeRoleWithWebIdentity` call for the provided role using the GoogleServiceAccount for this project.
       },
-      "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # An Azure Blob Storage data source.
+      "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # Optional. An Azure Blob Storage data source.
         "azureCredentials": { # Azure credentials For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Required. Input only. Credentials used to authenticate API requests to Azure. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
           "sasToken": "A String", # Required. Azure shared access signature (SAS). For more information about SAS, see [Grant limited access to Azure Storage resources using shared access signatures (SAS)](https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-overview).
         },
@@ -1134,12 +1134,12 @@ 
Method Details

         "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
         "storageAccount": "A String", # Required. The name of the Azure Storage account.
       },
-      "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data sink.
+      "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data sink.
         "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
         "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
         "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
       },
-      "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data source.
+      "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data source.
         "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
         "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
         "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
@@ -1149,10 +1149,10 @@ 
Method Details

         "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
         "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
       },
-      "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # An HDFS cluster data source.
+      "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # Optional. An HDFS cluster data source.
         "path": "A String", # Root path to transfer files.
       },
-      "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # An HTTP URL data source.
+      "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # Optional. An HTTP URL data source.
         "listUrl": "A String", # Required. The URL that points to the file that stores the object list entries. This file must allow public access. The URL is either an HTTP/HTTPS address (e.g. `https://example.com/urllist.tsv`) or a Cloud Storage path (e.g. `gs://my-bucket/urllist.tsv`).
       },
       "objectConditions": { # Conditions that determine which objects are transferred. Applies only to Cloud Data Sources such as S3, Azure, and Cloud Storage. The "last modification time" refers to the time of the last change to the object's content or metadata — specifically, this is the `updated` property of Cloud Storage objects, the `LastModified` field of S3 objects, and the `Last-Modified` header of Azure blobs. For S3 objects, the `LastModified` value is the time the object begins uploading. If the object meets your "last modification time" criteria, but has not finished uploading, the object is not transferred. See [Transfer from Amazon S3 to Cloud Storage](https://cloud.google.com/storage-transfer/docs/create-transfers/agentless/s3#transfer_options) for more information. Transfers with a PosixFilesystem source or destination don't support `ObjectConditions`. # Only objects that satisfy these object conditions are included in the set of data source and data sink objects. Object conditions based on objects' "last modification time" do not exclude objects in a data sink.
@@ -1167,10 +1167,10 @@ 
Method Details

         "maxTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred if a specific maximum time has elapsed since the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation`and the "last modification time" of the object is less than the value of max_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
         "minTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred until a specific minimum time has elapsed after the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation` and the "last modification time" of the object is equal to or greater than the value of min_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
       },
-      "posixDataSink": { # A POSIX filesystem resource. # A POSIX Filesystem data sink.
+      "posixDataSink": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data sink.
         "rootDirectory": "A String", # Root directory path to the filesystem.
       },
-      "posixDataSource": { # A POSIX filesystem resource. # A POSIX Filesystem data source.
+      "posixDataSource": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data source.
         "rootDirectory": "A String", # Root directory path to the filesystem.
       },
       "sinkAgentPoolName": "A String", # Specifies the agent pool name associated with the posix data sink. When unspecified, the default name is used.
@@ -1306,7 +1306,7 @@ 
Method Details

   "serviceAccount": "A String", # Optional. The user-managed service account to which to delegate service agent permissions. You can grant Cloud Storage bucket permissions to this service account instead of to the Transfer Service service agent. Format is `projects/-/serviceAccounts/ACCOUNT_EMAIL_OR_UNIQUEID` Either the service account email (`SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com`) or the unique ID (`123456789012345678901`) are accepted in the string. The `-` wildcard character is required; replacing it with a project ID is invalid. See https://cloud.google.com//storage-transfer/docs/delegate-service-agent-permissions for required permissions.
   "status": "A String", # Status of the job. This value MUST be specified for `CreateTransferJobRequests`. **Note:** The effect of the new job status takes place during a subsequent job run. For example, if you change the job status from ENABLED to DISABLED, and an operation spawned by the transfer is running, the status change would not affect the current operation.
   "transferSpec": { # Configuration for running a transfer. # Transfer specification.
-    "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # An AWS S3 compatible data source.
+    "awsS3CompatibleDataSource": { # An AwsS3CompatibleData resource. # Optional. An AWS S3 compatible data source.
       "bucketName": "A String", # Required. Specifies the name of the bucket.
       "endpoint": "A String", # Required. Specifies the endpoint of the storage service.
       "path": "A String", # Specifies the root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
@@ -1318,7 +1318,7 @@ 
Method Details

         "requestModel": "A String", # Specifies the API request model used to call the storage service. When not specified, the default value of RequestModel REQUEST_MODEL_VIRTUAL_HOSTED_STYLE is used.
       },
     },
-    "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # An AWS S3 data source.
+    "awsS3DataSource": { # An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name. # Optional. An AWS S3 data source.
       "awsAccessKey": { # AWS access key (see [AWS Security Credentials](https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html)). For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Input only. AWS access key used to sign the API requests to the AWS S3 bucket. Permissions on the bucket must be granted to the access ID of the AWS access key. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
         "accessKeyId": "A String", # Required. AWS access key ID.
         "secretAccessKey": "A String", # Required. AWS secret access key. This field is not returned in RPC responses.
@@ -1330,7 +1330,7 @@ 
Method Details

       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
       "roleArn": "A String", # The Amazon Resource Name (ARN) of the role to support temporary credentials via `AssumeRoleWithWebIdentity`. For more information about ARNs, see [IAM ARNs](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns). When a role ARN is provided, Transfer Service fetches temporary credentials for the session using a `AssumeRoleWithWebIdentity` call for the provided role using the GoogleServiceAccount for this project.
     },
-    "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # An Azure Blob Storage data source.
+    "azureBlobStorageDataSource": { # An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the [Azure endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob Storage blob's key name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). # Optional. An Azure Blob Storage data source.
       "azureCredentials": { # Azure credentials For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials). # Required. Input only. Credentials used to authenticate API requests to Azure. For information on our data retention policy for user credentials, see [User credentials](/storage-transfer/docs/data-retention#user-credentials).
         "sasToken": "A String", # Required. Azure shared access signature (SAS). For more information about SAS, see [Grant limited access to Azure Storage resources using shared access signatures (SAS)](https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-overview).
       },
@@ -1343,12 +1343,12 @@ 
Method Details

       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
       "storageAccount": "A String", # Required. The name of the Azure Storage account.
     },
-    "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data sink.
+    "gcsDataSink": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data sink.
       "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
     },
-    "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # A Cloud Storage data source.
+    "gcsDataSource": { # In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's `updated` property of Cloud Storage objects, which changes when the content or the metadata of the object is updated. # Optional. A Cloud Storage data source.
       "bucketName": "A String", # Required. Cloud Storage bucket name. Must meet [Bucket Name Requirements](/storage/docs/naming#requirements).
       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
@@ -1358,10 +1358,10 @@ 
Method Details

       "managedFolderTransferEnabled": True or False, # Preview. Enables the transfer of managed folders between Cloud Storage buckets. Set this option on the gcs_data_source. If set to true: - Managed folders in the source bucket are transferred to the destination bucket. - Managed folders in the destination bucket are overwritten. Other OVERWRITE options are not supported. See [Transfer Cloud Storage managed folders](/storage-transfer/docs/managed-folders).
       "path": "A String", # Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'. The root path value must meet [Object Name Requirements](/storage/docs/naming#objectnames).
     },
-    "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # An HDFS cluster data source.
+    "hdfsDataSource": { # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster). All cluster-specific settings, such as namenodes and ports, are configured on the transfer agents servicing requests, so HdfsData only contains the root path to the data in our transfer. # Optional. An HDFS cluster data source.
       "path": "A String", # Root path to transfer files.
     },
-    "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # An HTTP URL data source.
+    "httpDataSource": { # An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"`, which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields: * **HTTP URL** — The location of the object. * **Length** — The size of the object in bytes. * **MD5** — The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind: * When an object located at `http(s)://hostname:port/` is transferred to a data sink, the name of the object at the data sink is `/`. * If the specified size of an object does not match the actual size of the object fetched, the object is not transferred. * If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails. * Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly] (/storage/docs/cloud-console#_sharingdata) and get a link to it. * Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response. * ObjectConditions have no effect when filtering objects to transfer. # Optional. An HTTP URL data source.
       "listUrl": "A String", # Required. The URL that points to the file that stores the object list entries. This file must allow public access. The URL is either an HTTP/HTTPS address (e.g. `https://example.com/urllist.tsv`) or a Cloud Storage path (e.g. `gs://my-bucket/urllist.tsv`).
     },
     "objectConditions": { # Conditions that determine which objects are transferred. Applies only to Cloud Data Sources such as S3, Azure, and Cloud Storage. The "last modification time" refers to the time of the last change to the object's content or metadata — specifically, this is the `updated` property of Cloud Storage objects, the `LastModified` field of S3 objects, and the `Last-Modified` header of Azure blobs. For S3 objects, the `LastModified` value is the time the object begins uploading. If the object meets your "last modification time" criteria, but has not finished uploading, the object is not transferred. See [Transfer from Amazon S3 to Cloud Storage](https://cloud.google.com/storage-transfer/docs/create-transfers/agentless/s3#transfer_options) for more information. Transfers with a PosixFilesystem source or destination don't support `ObjectConditions`. # Only objects that satisfy these object conditions are included in the set of data source and data sink objects. Object conditions based on objects' "last modification time" do not exclude objects in a data sink.
@@ -1376,10 +1376,10 @@ 
Method Details

       "maxTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred if a specific maximum time has elapsed since the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation`and the "last modification time" of the object is less than the value of max_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
       "minTimeElapsedSinceLastModification": "A String", # Ensures that objects are not transferred until a specific minimum time has elapsed after the "last modification time". When a TransferOperation begins, objects with a "last modification time" are transferred only if the elapsed time between the start_time of the `TransferOperation` and the "last modification time" of the object is equal to or greater than the value of min_time_elapsed_since_last_modification`. Objects that do not have a "last modification time" are also transferred.
     },
-    "posixDataSink": { # A POSIX filesystem resource. # A POSIX Filesystem data sink.
+    "posixDataSink": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data sink.
       "rootDirectory": "A String", # Root directory path to the filesystem.
     },
-    "posixDataSource": { # A POSIX filesystem resource. # A POSIX Filesystem data source.
+    "posixDataSource": { # A POSIX filesystem resource. # Optional. A POSIX Filesystem data source.
       "rootDirectory": "A String", # Root directory path to the filesystem.
     },
     "sinkAgentPoolName": "A String", # Specifies the agent pool name associated with the posix data sink. When unspecified, the default name is used.
diff --git a/docs/dyn/vision_v1.files.html b/docs/dyn/vision_v1.files.html
index 25bf04de2fc..8870f75716d 100644
--- a/docs/dyn/vision_v1.files.html
+++ b/docs/dyn/vision_v1.files.html
@@ -102,7 +102,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -780,7 +780,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1.images.html b/docs/dyn/vision_v1.images.html
index 786b7c2d4ff..97375e3e9cd 100644
--- a/docs/dyn/vision_v1.images.html
+++ b/docs/dyn/vision_v1.images.html
@@ -102,7 +102,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -762,7 +762,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1.projects.files.html b/docs/dyn/vision_v1.projects.files.html
index 8d54e6ac1c9..bf697bfbf44 100644
--- a/docs/dyn/vision_v1.projects.files.html
+++ b/docs/dyn/vision_v1.projects.files.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -782,7 +782,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1.projects.images.html b/docs/dyn/vision_v1.projects.images.html
index 57c06788839..c251303bce9 100644
--- a/docs/dyn/vision_v1.projects.images.html
+++ b/docs/dyn/vision_v1.projects.images.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -764,7 +764,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1.projects.locations.files.html b/docs/dyn/vision_v1.projects.locations.files.html
index 806ddf1a2dd..07d8f8c0452 100644
--- a/docs/dyn/vision_v1.projects.locations.files.html
+++ b/docs/dyn/vision_v1.projects.locations.files.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -782,7 +782,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1.projects.locations.images.html b/docs/dyn/vision_v1.projects.locations.images.html
index db01f52b6bd..01bc5e8f187 100644
--- a/docs/dyn/vision_v1.projects.locations.images.html
+++ b/docs/dyn/vision_v1.projects.locations.images.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -764,7 +764,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p1beta1.files.html b/docs/dyn/vision_v1p1beta1.files.html
index 23b04ec73fa..8dc6759ed1e 100644
--- a/docs/dyn/vision_v1p1beta1.files.html
+++ b/docs/dyn/vision_v1p1beta1.files.html
@@ -102,7 +102,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -780,7 +780,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p1beta1.images.html b/docs/dyn/vision_v1p1beta1.images.html
index 48deaf5dee5..34372eaf0fd 100644
--- a/docs/dyn/vision_v1p1beta1.images.html
+++ b/docs/dyn/vision_v1p1beta1.images.html
@@ -102,7 +102,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -762,7 +762,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p1beta1.projects.files.html b/docs/dyn/vision_v1p1beta1.projects.files.html
index c711a07ee17..1ea40513d8d 100644
--- a/docs/dyn/vision_v1p1beta1.projects.files.html
+++ b/docs/dyn/vision_v1p1beta1.projects.files.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -782,7 +782,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p1beta1.projects.images.html b/docs/dyn/vision_v1p1beta1.projects.images.html
index 27772a15d11..609091441d8 100644
--- a/docs/dyn/vision_v1p1beta1.projects.images.html
+++ b/docs/dyn/vision_v1p1beta1.projects.images.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -764,7 +764,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p1beta1.projects.locations.files.html b/docs/dyn/vision_v1p1beta1.projects.locations.files.html
index ce3a509455d..bf0ee0b4b6f 100644
--- a/docs/dyn/vision_v1p1beta1.projects.locations.files.html
+++ b/docs/dyn/vision_v1p1beta1.projects.locations.files.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -782,7 +782,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p1beta1.projects.locations.images.html b/docs/dyn/vision_v1p1beta1.projects.locations.images.html
index 3b375a17092..04cd9459422 100644
--- a/docs/dyn/vision_v1p1beta1.projects.locations.images.html
+++ b/docs/dyn/vision_v1p1beta1.projects.locations.images.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -764,7 +764,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p2beta1.files.html b/docs/dyn/vision_v1p2beta1.files.html
index 09e83fa6eb8..6e28b367e44 100644
--- a/docs/dyn/vision_v1p2beta1.files.html
+++ b/docs/dyn/vision_v1p2beta1.files.html
@@ -102,7 +102,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -780,7 +780,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p2beta1.images.html b/docs/dyn/vision_v1p2beta1.images.html
index 1903510f3ed..f141cf57c29 100644
--- a/docs/dyn/vision_v1p2beta1.images.html
+++ b/docs/dyn/vision_v1p2beta1.images.html
@@ -102,7 +102,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -762,7 +762,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p2beta1.projects.files.html b/docs/dyn/vision_v1p2beta1.projects.files.html
index 616dd2b9c98..f33fccc5250 100644
--- a/docs/dyn/vision_v1p2beta1.projects.files.html
+++ b/docs/dyn/vision_v1p2beta1.projects.files.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -782,7 +782,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p2beta1.projects.images.html b/docs/dyn/vision_v1p2beta1.projects.images.html
index 204d3714341..df502882859 100644
--- a/docs/dyn/vision_v1p2beta1.projects.images.html
+++ b/docs/dyn/vision_v1p2beta1.projects.images.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -764,7 +764,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p2beta1.projects.locations.files.html b/docs/dyn/vision_v1p2beta1.projects.locations.files.html
index b81f3d05cd4..a80f38548d2 100644
--- a/docs/dyn/vision_v1p2beta1.projects.locations.files.html
+++ b/docs/dyn/vision_v1p2beta1.projects.locations.files.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -782,7 +782,7 @@ 
Method Details

       "features": [ # Required. Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/docs/dyn/vision_v1p2beta1.projects.locations.images.html b/docs/dyn/vision_v1p2beta1.projects.locations.images.html
index 7759bae1963..bfddd44417e 100644
--- a/docs/dyn/vision_v1p2beta1.projects.locations.images.html
+++ b/docs/dyn/vision_v1p2beta1.projects.locations.images.html
@@ -103,7 +103,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
@@ -764,7 +764,7 @@ 
Method Details

       "features": [ # Requested features.
         { # The type of Google Cloud Vision API detection to perform, and the maximum number of results to return for that type. Multiple `Feature` objects can be specified in the `features` list.
           "maxResults": 42, # Maximum number of results of this type. Does not apply to `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
-          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/weekly" for the bleeding edge release updated weekly.
+          "model": "A String", # Model to use for the feature. Supported values: "builtin/stable" (the default if unset) and "builtin/latest". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support "builtin/rc" for the latest release candidate.
           "type": "A String", # The feature type.
         },
       ],
diff --git a/googleapiclient/discovery_cache/documents/adexchangebuyer2.v2beta1.json b/googleapiclient/discovery_cache/documents/adexchangebuyer2.v2beta1.json
index 4ac7434d43f..9447ddf417c 100644
--- a/googleapiclient/discovery_cache/documents/adexchangebuyer2.v2beta1.json
+++ b/googleapiclient/discovery_cache/documents/adexchangebuyer2.v2beta1.json
@@ -3115,7 +3115,7 @@
 }
 }
 },
-"revision": "20241002",
+"revision": "20250807",
 "rootUrl": "https://adexchangebuyer.googleapis.com/",
 "schemas": {
 "AbsoluteDateRange": {
@@ -5661,14 +5661,16 @@
 "AD_NOT_RENDERED",
 "INVALID_IMPRESSION",
 "FATAL_VAST_ERROR",
-"LOST_IN_MEDIATION"
+"LOST_IN_MEDIATION",
+"OVERDELIVERED_IMPRESSION"
 ],
 "enumDescriptions": [
 "A placeholder for an undefined status. This value will never be returned in responses.",
 "The buyer was not billed because the ad was not rendered by the publisher.",
 "The buyer was not billed because the impression won by the bid was determined to be invalid.",
 "A video impression was served but a fatal error was reported from the client during playback.",
-"The buyer was not billed because the ad was outplaced in the mediation waterfall."
+"The buyer was not billed because the ad was outplaced in the mediation waterfall.",
+"The impression was not billed because it exceeded a guaranteed deal delivery goal."
 ],
 "type": "string"
 }
diff --git a/googleapiclient/discovery_cache/documents/androidmanagement.v1.json b/googleapiclient/discovery_cache/documents/androidmanagement.v1.json
index bb362e53d55..6ba866c1bab 100644
--- a/googleapiclient/discovery_cache/documents/androidmanagement.v1.json
+++ b/googleapiclient/discovery_cache/documents/androidmanagement.v1.json
@@ -453,7 +453,7 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "The requested page size. The actual page size may be fixed to a min or max value.",
+"description": "The requested page size. If unspecified, at most 10 devices will be returned. The maximum value is 100; values above 100 will be coerced to 100. The limits can change over time.",
 "format": "int32",
 "location": "query",
 "type": "integer"
@@ -1260,7 +1260,7 @@
 }
 }
 },
-"revision": "20250714",
+"revision": "20250804",
 "rootUrl": "https://androidmanagement.googleapis.com/",
 "schemas": {
 "AdbShellCommandEvent": {
diff --git a/googleapiclient/discovery_cache/documents/apim.v1alpha.json b/googleapiclient/discovery_cache/documents/apim.v1alpha.json
index 08ed374c3f4..9fd4aa8b606 100644
--- a/googleapiclient/discovery_cache/documents/apim.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/apim.v1alpha.json
@@ -134,6 +134,31 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"getEntitlement": {
+"description": "GetEntitlement returns the entitlement for the provided project.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/entitlement",
+"httpMethod": "GET",
+"id": "apim.projects.locations.getEntitlement",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The entitlement resource name Format: projects/{project}/locations/{location}/entitlement",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/entitlement$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+name}",
+"response": {
+"$ref": "Entitlement"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "list": {
 "description": "Lists information about the supported locations for this service.",
 "flatPath": "v1alpha/projects/{projectsId}/locations",
@@ -821,7 +846,7 @@
 }
 }
 },
-"revision": "20250521",
+"revision": "20250730",
 "rootUrl": "https://apim.googleapis.com/",
 "schemas": {
 "ApiObservation": {
@@ -996,6 +1021,38 @@
 "properties": {},
 "type": "object"
 },
+"Entitlement": {
+"description": "Entitlement stores data related to API Observation entitlement for a given project",
+"id": "Entitlement",
+"properties": {
+"apiObservationEntitled": {
+"description": "Whether API Observation is entitled.",
+"type": "boolean"
+},
+"billingProjectNumber": {
+"description": "Project number of associated billing project that has Apigee and Advanced API Security entitled.",
+"format": "int64",
+"type": "string"
+},
+"createTime": {
+"description": "Output only. The time of the entitlement creation.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"name": {
+"description": "Identifier. The entitlement resource name `projects/{project}/locations/{location}/entitlement`",
+"type": "string"
+},
+"updateTime": {
+"description": "Output only. The time of the entitlement update.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "GclbObservationSource": {
 "description": "The GCLB observation source.",
 "id": "GclbObservationSource",
diff --git a/googleapiclient/discovery_cache/documents/appengine.v1.json b/googleapiclient/discovery_cache/documents/appengine.v1.json
index e433b971f6c..99dd677a4da 100644
--- a/googleapiclient/discovery_cache/documents/appengine.v1.json
+++ b/googleapiclient/discovery_cache/documents/appengine.v1.json
@@ -140,7 +140,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the Application resource to get. Example: apps/myapp.",
+"description": "Part of `name`. Required. Name of the Application resource to get. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -222,7 +222,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the Application resource to update. Example: apps/myapp.",
+"description": "Part of `name`. Required. Name of the Application resource to update. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -255,7 +255,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the application to repair. Example: apps/myapp",
+"description": "Part of `name`. Required. Name of the application to repair. Example: apps/myapp",
 "location": "path",
 "required": true,
 "type": "string"
@@ -286,7 +286,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -314,7 +314,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -345,7 +345,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -390,7 +390,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -441,7 +441,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -484,7 +484,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -525,7 +525,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -568,7 +568,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -599,7 +599,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -631,7 +631,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -669,7 +669,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -741,7 +741,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Firewall collection in which to create a new rule. Example: apps/myapp/firewall/ingressRules.",
+"description": "Part of `parent`. Required. Name of the parent Firewall collection in which to create a new rule. Example: apps/myapp/firewall/ingressRules.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1085,7 +1085,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1116,7 +1116,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1148,7 +1148,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1186,7 +1186,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/services/default.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1235,7 +1235,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent resource to create this version under. Example: apps/myapp/services/default.",
+"description": "Part of `parent`. Required. Name of the parent resource to create this version under. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1270,7 +1270,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1308,7 +1308,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1360,7 +1360,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Service resource. Example: apps/myapp/services/default.",
+"description": "Part of `parent`. Required. Name of the parent Service resource. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1418,7 +1418,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/services/default/versions/1.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default/versions/1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1470,7 +1470,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1518,7 +1518,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1563,7 +1563,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1609,7 +1609,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Version resource. Example: apps/myapp/services/default/versions/v1.",
+"description": "Part of `parent`. Required. Name of the parent Version resource. Example: apps/myapp/services/default/versions/v1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1686,7 +1686,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the Application resource to update. Example: apps/myapp.",
+"description": "Part of `name`. Required. Name of the Application resource to update. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1737,7 +1737,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1785,7 +1785,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1830,7 +1830,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1894,7 +1894,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1954,7 +1954,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2016,7 +2016,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2075,7 +2075,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2123,7 +2123,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2168,7 +2168,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2218,7 +2218,7 @@
 "type": "boolean"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/services/default.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2277,7 +2277,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2329,7 +2329,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/services/default/versions/1.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default/versions/1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2375,7 +2375,7 @@
 }
 }
 },
-"revision": "20250616",
+"revision": "20250805",
 "rootUrl": "https://appengine.googleapis.com/",
 "schemas": {
 "ApiConfigHandler": {
@@ -2532,7 +2532,6 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly",
 "readOnly": true,
 "type": "string"
 },
@@ -3103,7 +3102,7 @@
 "type": "object"
 },
 "FirewallRule": {
-"description": "A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.",
+"description": "A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.",
 "id": "FirewallRule",
 "properties": {
 "action": {
@@ -3125,7 +3124,6 @@
 "type": "string"
 },
 "priority": {
-"description": "A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.",
 "format": "int32",
 "type": "integer"
 },
diff --git a/googleapiclient/discovery_cache/documents/appengine.v1alpha.json b/googleapiclient/discovery_cache/documents/appengine.v1alpha.json
index baabfc0cee3..52a25e193d2 100644
--- a/googleapiclient/discovery_cache/documents/appengine.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/appengine.v1alpha.json
@@ -124,7 +124,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -152,7 +152,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -183,7 +183,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -228,7 +228,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -279,7 +279,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -322,7 +322,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -363,7 +363,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -411,7 +411,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -442,7 +442,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -474,7 +474,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -512,7 +512,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -829,7 +829,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -877,7 +877,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -922,7 +922,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -986,7 +986,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1046,7 +1046,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1108,7 +1108,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1172,7 +1172,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1220,7 +1220,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1338,7 +1338,7 @@
 }
 }
 },
-"revision": "20250616",
+"revision": "20250805",
 "rootUrl": "https://appengine.googleapis.com/",
 "schemas": {
 "AuthorizedCertificate": {
diff --git a/googleapiclient/discovery_cache/documents/appengine.v1beta.json b/googleapiclient/discovery_cache/documents/appengine.v1beta.json
index 584ebf17dc8..269de594c17 100644
--- a/googleapiclient/discovery_cache/documents/appengine.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/appengine.v1beta.json
@@ -140,7 +140,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the Application resource to get. Example: apps/myapp.",
+"description": "Part of `name`. Required. Name of the Application resource to get. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -222,7 +222,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the Application resource to update. Example: apps/myapp.",
+"description": "Part of `name`. Required. Name of the Application resource to update. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -255,7 +255,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the application to repair. Example: apps/myapp",
+"description": "Part of `name`. Required. Name of the application to repair. Example: apps/myapp",
 "location": "path",
 "required": true,
 "type": "string"
@@ -286,7 +286,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -314,7 +314,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -345,7 +345,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -390,7 +390,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -441,7 +441,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -484,7 +484,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -525,7 +525,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -568,7 +568,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -599,7 +599,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -631,7 +631,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -669,7 +669,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -741,7 +741,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Firewall collection in which to create a new rule. Example: apps/myapp/firewall/ingressRules.",
+"description": "Part of `parent`. Required. Name of the parent Firewall collection in which to create a new rule. Example: apps/myapp/firewall/ingressRules.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1085,7 +1085,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1116,7 +1116,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1163,7 +1163,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1201,7 +1201,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/services/default.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1250,7 +1250,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent resource to create this version under. Example: apps/myapp/services/default.",
+"description": "Part of `parent`. Required. Name of the parent resource to create this version under. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1285,7 +1285,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1323,7 +1323,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1390,7 +1390,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Service resource. Example: apps/myapp/services/default.",
+"description": "Part of `parent`. Required. Name of the parent Service resource. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1448,7 +1448,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/services/default/versions/1.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default/versions/1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1500,7 +1500,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1548,7 +1548,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1593,7 +1593,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1639,7 +1639,7 @@
 ],
 "parameters": {
 "appsId": {
-"description": "Part of `parent`. Name of the parent Version resource. Example: apps/myapp/services/default/versions/v1.",
+"description": "Part of `parent`. Required. Name of the parent Version resource. Example: apps/myapp/services/default/versions/v1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1799,7 +1799,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the Application resource to update. Example: apps/myapp.",
+"description": "Part of `name`. Required. Name of the Application resource to update. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1850,7 +1850,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1898,7 +1898,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1943,7 +1943,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2007,7 +2007,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2067,7 +2067,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2129,7 +2129,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2188,7 +2188,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
+"description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2236,7 +2236,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2281,7 +2281,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2331,7 +2331,7 @@
 "type": "boolean"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/services/default.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2390,7 +2390,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
+"description": "Part of `name`. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2442,7 +2442,7 @@
 "type": "string"
 },
 "projectsId": {
-"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/services/default/versions/1.",
+"description": "Part of `name`. Required. Name of the resource to update. Example: apps/myapp/services/default/versions/1.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2581,7 +2581,7 @@
 }
 }
 },
-"revision": "20250616",
+"revision": "20250805",
 "rootUrl": "https://appengine.googleapis.com/",
 "schemas": {
 "ApiConfigHandler": {
@@ -2738,7 +2738,6 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly",
 "readOnly": true,
 "type": "string"
 },
@@ -3360,7 +3359,7 @@
 "type": "object"
 },
 "FirewallRule": {
-"description": "A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests.",
+"description": "A single firewall rule that is evaluated against incoming traffic and provides an action to take on matched requests. A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.",
 "id": "FirewallRule",
 "properties": {
 "action": {
@@ -3382,7 +3381,6 @@
 "type": "string"
 },
 "priority": {
-"description": "A positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.",
 "format": "int32",
 "type": "integer"
 },
diff --git a/googleapiclient/discovery_cache/documents/chat.v1.json b/googleapiclient/discovery_cache/documents/chat.v1.json
index c4bf2fa94d9..01f01612ad6 100644
--- a/googleapiclient/discovery_cache/documents/chat.v1.json
+++ b/googleapiclient/discovery_cache/documents/chat.v1.json
@@ -1528,7 +1528,7 @@
 }
 }
 },
-"revision": "20250727",
+"revision": "20250731",
 "rootUrl": "https://chat.googleapis.com/",
 "schemas": {
 "AccessSettings": {
@@ -4950,7 +4950,7 @@
 "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.",
+"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.",
 "type": "string"
 },
 "displayName": {
diff --git a/googleapiclient/discovery_cache/documents/composer.v1.json b/googleapiclient/discovery_cache/documents/composer.v1.json
index 67935e02813..11725b1904c 100644
--- a/googleapiclient/discovery_cache/documents/composer.v1.json
+++ b/googleapiclient/discovery_cache/documents/composer.v1.json
@@ -1226,7 +1226,7 @@
 }
 }
 },
-"revision": "20250630",
+"revision": "20250803",
 "rootUrl": "https://composer.googleapis.com/",
 "schemas": {
 "AirflowMetadataRetentionPolicyConfig": {
@@ -2194,7 +2194,8 @@
 "CHECK",
 "SAVE_SNAPSHOT",
 "LOAD_SNAPSHOT",
-"DATABASE_FAILOVER"
+"DATABASE_FAILOVER",
+"MIGRATE"
 ],
 "enumDescriptions": [
 "Unused.",
@@ -2204,7 +2205,8 @@
 "A resource check operation.",
 "Saves snapshot of the resource operation.",
 "Loads snapshot of the resource operation.",
-"Triggers failover of environment's Cloud SQL instance (only for highly resilient environments)."
+"Triggers failover of environment's Cloud SQL instance (only for highly resilient environments).",
+"Migrates resource to a new major version."
 ],
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/composer.v1beta1.json b/googleapiclient/discovery_cache/documents/composer.v1beta1.json
index 94e0f920133..aa63b2029d8 100644
--- a/googleapiclient/discovery_cache/documents/composer.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/composer.v1beta1.json
@@ -1226,7 +1226,7 @@
 }
 }
 },
-"revision": "20250630",
+"revision": "20250803",
 "rootUrl": "https://composer.googleapis.com/",
 "schemas": {
 "AirflowMetadataRetentionPolicyConfig": {
@@ -2211,7 +2211,8 @@
 "CHECK",
 "SAVE_SNAPSHOT",
 "LOAD_SNAPSHOT",
-"DATABASE_FAILOVER"
+"DATABASE_FAILOVER",
+"MIGRATE"
 ],
 "enumDescriptions": [
 "Unused.",
@@ -2221,7 +2222,8 @@
 "A resource check operation.",
 "Saves snapshot of the resource operation.",
 "Loads snapshot of the resource operation.",
-"Triggers failover of environment's Cloud SQL instance (only for highly resilient environments)."
+"Triggers failover of environment's Cloud SQL instance (only for highly resilient environments).",
+"Migrates resource to a new major version."
 ],
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/dataplex.v1.json b/googleapiclient/discovery_cache/documents/dataplex.v1.json
index f14d84ff653..4f92d012c3f 100644
--- a/googleapiclient/discovery_cache/documents/dataplex.v1.json
+++ b/googleapiclient/discovery_cache/documents/dataplex.v1.json
@@ -12,7 +12,7 @@
 "baseUrl": "https://dataplex.googleapis.com/",
 "batchPath": "batch",
 "canonicalName": "Cloud Dataplex",
-"description": "Dataplex API is used to manage the lifecycle of data lakes.",
+"description": "A unified, intelligent governance solution for data and AI assets.",
 "discoveryVersion": "v1",
 "documentationLink": "https://cloud.google.com/dataplex/docs",
 "endpoints": [
@@ -902,7 +902,7 @@
 "type": "string"
 },
 "query": {
-"description": "Required. The query against which entries in scope should be matched. The query syntax is defined in Search syntax for Dataplex Catalog (https://cloud.google.com/dataplex/docs/search-syntax).",
+"description": "Required. The query against which entries in scope should be matched. The query syntax is defined in Search syntax for Dataplex Universal Catalog (https://cloud.google.com/dataplex/docs/search-syntax).",
 "location": "query",
 "type": "string"
 },
@@ -6973,7 +6973,7 @@
 ]
 },
 "create": {
-"description": "Creates a metadata job. For example, use a metadata job to import Dataplex Catalog entries and aspects from a third-party system into Dataplex.",
+"description": "Creates a metadata job. For example, use a metadata job to import metadata from a third-party system into Dataplex Universal Catalog.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/metadataJobs",
 "httpMethod": "POST",
 "id": "dataplex.projects.locations.metadataJobs.create",
@@ -7211,7 +7211,7 @@
 }
 }
 },
-"revision": "20250729",
+"revision": "20250805",
 "rootUrl": "https://dataplex.googleapis.com/",
 "schemas": {
 "Empty": {
@@ -7567,7 +7567,7 @@
 "id": "GoogleCloudDataplexV1AspectTypeAuthorization",
 "properties": {
 "alternateUsePermission": {
-"description": "Immutable. The IAM permission grantable on the EntryGroup to allow access to instantiate Aspects of Dataplex owned AspectTypes, only settable for Dataplex owned Types.",
+"description": "Immutable. The IAM permission grantable on the EntryGroup to allow access to instantiate Aspects of Dataplex Universal Catalog owned AspectTypes, only settable for Dataplex Universal Catalog owned Types.",
 "type": "string"
 }
 },
@@ -8680,7 +8680,7 @@
 "description": "Profile information for the corresponding field."
 },
 "type": {
-"description": "The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).",
+"description": "The data type retrieved from the schema of the data source. For instance, for a BigQuery native table, it is the BigQuery Table Schema (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablefieldschema). For a Dataplex Universal Catalog Entity, it is the Entity Schema (https://cloud.google.com/dataplex/docs/reference/rpc/google.cloud.dataplex.v1#type_3).",
 "type": "string"
 }
 },
@@ -8970,7 +8970,7 @@
 "properties": {
 "catalogPublishingStatus": {
 "$ref": "GoogleCloudDataplexV1DataScanCatalogPublishingStatus",
-"description": "Output only. The status of publishing the data scan to Catalog.",
+"description": "Output only. The status of publishing the data scan as Dataplex Universal Catalog metadata.",
 "readOnly": true
 },
 "columns": {
@@ -9437,7 +9437,7 @@
 "id": "GoogleCloudDataplexV1DataQualitySpec",
 "properties": {
 "catalogPublishingEnabled": {
-"description": "Optional. If set, the latest DataScan job result will be published to Dataplex Catalog.",
+"description": "Optional. If set, the latest DataScan job result will be published as Dataplex Universal Catalog metadata.",
 "type": "boolean"
 },
 "postScanActions": {
@@ -9671,7 +9671,7 @@
 "type": "object"
 },
 "GoogleCloudDataplexV1DataScanCatalogPublishingStatus": {
-"description": "The status of publishing the data scan result to Catalog.",
+"description": "The status of publishing the data scan result as Dataplex Universal Catalog metadata.",
 "id": "GoogleCloudDataplexV1DataScanCatalogPublishingStatus",
 "properties": {
 "state": {
@@ -9698,7 +9698,7 @@
 "properties": {
 "catalogPublishingStatus": {
 "$ref": "GoogleCloudDataplexV1DataScanCatalogPublishingStatus",
-"description": "The status of publishing the data scan to Catalog."
+"description": "The status of publishing the data scan as Dataplex Universal Catalog metadata."
 },
 "createTime": {
 "description": "The time when the data scan job was created.",
@@ -10100,7 +10100,7 @@
 "id": "GoogleCloudDataplexV1DataSource",
 "properties": {
 "entity": {
-"description": "Immutable. The Dataplex entity that represents the data source (e.g. BigQuery table) for DataScan, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}.",
+"description": "Immutable. The Dataplex Universal Catalog entity that represents the data source (e.g. BigQuery table) for DataScan, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}.",
 "type": "string"
 },
 "resource": {
@@ -10605,7 +10605,7 @@
 "type": "object"
 },
 "createTime": {
-"description": "Output only. The time when the entry was created in Dataplex.",
+"description": "Output only. The time when the entry was created in Dataplex Universal Catalog.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
@@ -10631,7 +10631,7 @@
 "type": "string"
 },
 "updateTime": {
-"description": "Output only. The time when the entry was last updated in Dataplex.",
+"description": "Output only. The time when the entry was last updated in Dataplex Universal Catalog.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
@@ -10955,7 +10955,7 @@
 "id": "GoogleCloudDataplexV1EntryTypeAuthorization",
 "properties": {
 "alternateUsePermission": {
-"description": "Immutable. The IAM permission grantable on the Entry Group to allow access to instantiate Entries of Dataplex owned Entry Types, only settable for Dataplex owned Types.",
+"description": "Immutable. The IAM permission grantable on the Entry Group to allow access to instantiate Entries of Dataplex Universal Catalog owned Entry Types, only settable for Dataplex Universal Catalog owned Types.",
 "type": "string"
 }
 },
@@ -11101,7 +11101,7 @@
 "id": "GoogleCloudDataplexV1EnvironmentInfrastructureSpecOsImageRuntime",
 "properties": {
 "imageVersion": {
-"description": "Required. Dataplex Image version.",
+"description": "Required. Dataplex Universal Catalog Image version.",
 "type": "string"
 },
 "javaLibraries": {
@@ -11167,7 +11167,7 @@
 "id": "GoogleCloudDataplexV1GenerateDataQualityRulesResponse",
 "properties": {
 "rule": {
-"description": "The data quality rules that Dataplex generates based on the results of a data profiling scan.",
+"description": "The data quality rules that Dataplex Universal Catalog generates based on the results of a data profiling scan.",
 "items": {
 "$ref": "GoogleCloudDataplexV1DataQualityRule"
 },
@@ -11419,7 +11419,7 @@
 "id": "GoogleCloudDataplexV1ImportItem",
 "properties": {
 "aspectKeys": {
-"description": "The aspects to modify. Supports the following syntaxes: {aspect_type_reference}: matches aspects that belong to the specified aspect type and are attached directly to the entry. {aspect_type_reference}@{path}: matches aspects that belong to the specified aspect type and path. {aspect_type_reference}@* : matches aspects of the given type for all paths. *@path : matches aspects of all types on the given path.Replace {aspect_type_reference} with a reference to the aspect type, in the format {project_id_or_number}.{location_id}.{aspect_type_id}.In FULL entry sync mode, if you leave this field empty, it is treated as specifying exactly those aspects that are present within the specified entry. Dataplex implicitly adds the keys for all of the required aspects of an entry.",
+"description": "The aspects to modify. Supports the following syntaxes: {aspect_type_reference}: matches aspects that belong to the specified aspect type and are attached directly to the entry. {aspect_type_reference}@{path}: matches aspects that belong to the specified aspect type and path. {aspect_type_reference}@* : matches aspects of the given type for all paths. *@path : matches aspects of all types on the given path.Replace {aspect_type_reference} with a reference to the aspect type, in the format {project_id_or_number}.{location_id}.{aspect_type_id}.In FULL entry sync mode, if you leave this field empty, it is treated as specifying exactly those aspects that are present within the specified entry. Dataplex Universal Catalog implicitly adds the keys for all of the required aspects of an entry.",
 "items": {
 "type": "string"
 },
@@ -11434,7 +11434,7 @@
 "description": "Information about the entry link. User should provide either one of the entry or entry_link. While providing entry_link, user should not provide update_mask and aspect_keys."
 },
 "updateMask": {
-"description": "The fields to update, in paths that are relative to the Entry resource. Separate each field with a comma.In FULL entry sync mode, Dataplex includes the paths of all of the fields for an entry that can be modified, including aspects. This means that Dataplex replaces the existing entry with the entry in the metadata import file. All modifiable fields are updated, regardless of the fields that are listed in the update mask, and regardless of whether a field is present in the entry object.The update_mask field is ignored when an entry is created or re-created.In an aspect-only metadata job (when entry sync mode is NONE), set this value to aspects.Dataplex also determines which entries and aspects to modify by comparing the values and timestamps that you provide in the metadata import file with the values and timestamps that exist in your project. For more information, see Comparison logic (https://cloud.google.com/dataplex/docs/import-metadata#data-modification-logic).",
+"description": "The fields to update, in paths that are relative to the Entry resource. Separate each field with a comma.In FULL entry sync mode, Dataplex Universal Catalog includes the paths of all of the fields for an entry that can be modified, including aspects. This means that Dataplex Universal Catalog replaces the existing entry with the entry in the metadata import file. All modifiable fields are updated, regardless of the fields that are listed in the update mask, and regardless of whether a field is present in the entry object.The update_mask field is ignored when an entry is created or re-created.In an aspect-only metadata job (when entry sync mode is NONE), set this value to aspects.Dataplex Universal Catalog also determines which entries and aspects to modify by comparing the values and timestamps that you provide in the metadata import file with the values and timestamps that exist in your project. For more information, see Comparison logic (https://cloud.google.com/dataplex/docs/import-metadata#data-modification-logic).",
 "format": "google-fieldmask",
 "type": "string"
 }
@@ -11522,7 +11522,7 @@
 "The job cancellation was successful.",
 "The job completed successfully.",
 "The job is no longer running due to an error.",
-"The job was cancelled outside of Dataplex."
+"The job was cancelled outside of Dataplex Universal Catalog."
 ],
 "readOnly": true,
 "type": "string"
@@ -11536,7 +11536,7 @@
 ],
 "enumDescriptions": [
 "The trigger is unspecified.",
-"The job was triggered by Dataplex based on trigger spec from task definition.",
+"The job was triggered by Dataplex Universal Catalog based on trigger spec from task definition.",
 "The job was triggered by the explicit call of Task API."
 ],
 "readOnly": true,
@@ -11568,7 +11568,7 @@
 ],
 "enumDescriptions": [
 "The job execution trigger is unspecified.",
-"The job was triggered by Dataplex based on trigger spec from task definition.",
+"The job was triggered by Dataplex Universal Catalog based on trigger spec from task definition.",
 "The job was triggered by the explicit call of Task API."
 ],
 "type": "string"
@@ -12417,7 +12417,7 @@
 "id": "GoogleCloudDataplexV1MetadataJobExportJobSpec",
 "properties": {
 "outputPath": {
-"description": "Required. The root path of the Cloud Storage bucket to export the metadata to, in the format gs://{bucket}/. You can optionally specify a custom prefix after the bucket name, in the format gs://{bucket}/{prefix}/. The maximum length of the custom prefix is 128 characters. Dataplex constructs the object path for the exported files by using the bucket name and prefix that you provide, followed by a system-generated path.The bucket must be in the same VPC Service Controls perimeter as the job.",
+"description": "Required. The root path of the Cloud Storage bucket to export the metadata to, in the format gs://{bucket}/. You can optionally specify a custom prefix after the bucket name, in the format gs://{bucket}/{prefix}/. The maximum length of the custom prefix is 128 characters. Dataplex Universal Catalog constructs the object path for the exported files by using the bucket name and prefix that you provide, followed by a system-generated path.The bucket must be in the same VPC Service Controls perimeter as the job.",
 "type": "string"
 },
 "scope": {
@@ -12541,7 +12541,7 @@
 ],
 "enumDescriptions": [
 "Sync mode unspecified.",
-"All resources in the job's scope are modified. If a resource exists in Dataplex but isn't included in the metadata import file, the resource is deleted when you run the metadata job. Use this mode to perform a full sync of the set of entries in the job scope.This sync mode is supported for entries.",
+"All resources in the job's scope are modified. If a resource exists in Dataplex Universal Catalog but isn't included in the metadata import file, the resource is deleted when you run the metadata job. Use this mode to perform a full sync of the set of entries in the job scope.This sync mode is supported for entries.",
 "Only the resources that are explicitly included in the metadata import file are modified. Use this mode to modify a subset of resources while leaving unreferenced resources unchanged.This sync mode is supported for aspects.",
 "If entry sync mode is NONE, then aspects are modified according to the aspect sync mode. Other metadata that belongs to entries in the job's scope isn't modified.This sync mode is supported for entries."
 ],
@@ -12557,7 +12557,7 @@
 ],
 "enumDescriptions": [
 "Sync mode unspecified.",
-"All resources in the job's scope are modified. If a resource exists in Dataplex but isn't included in the metadata import file, the resource is deleted when you run the metadata job. Use this mode to perform a full sync of the set of entries in the job scope.This sync mode is supported for entries.",
+"All resources in the job's scope are modified. If a resource exists in Dataplex Universal Catalog but isn't included in the metadata import file, the resource is deleted when you run the metadata job. Use this mode to perform a full sync of the set of entries in the job scope.This sync mode is supported for entries.",
 "Only the resources that are explicitly included in the metadata import file are modified. Use this mode to modify a subset of resources while leaving unreferenced resources unchanged.This sync mode is supported for aspects.",
 "If entry sync mode is NONE, then aspects are modified according to the aspect sync mode. Other metadata that belongs to entries in the job's scope isn't modified.This sync mode is supported for entries."
 ],
@@ -12899,7 +12899,7 @@
 "type": "string"
 },
 "userManaged": {
-"description": "Required. Set to true if user-managed or false if managed by Dataplex. The default is false (managed by Dataplex). Set to falseto enable Dataplex discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex treats schema input by the user as though produced by a previous Dataplex discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex will not change schema fields.",
+"description": "Required. Set to true if user-managed or false if managed by Dataplex Universal Catalog. The default is false (managed by Dataplex Universal Catalog). Set to falseto enable Dataplex Universal Catalog discovery to update the schema. including new data discovery, schema inference, and schema evolution. Users retain the ability to input and edit the schema. Dataplex Universal Catalog treats schema input by the user as though produced by a previous Dataplex Universal Catalog discovery operation, and it will evolve the schema and take action based on that treatment. Set to true to fully manage the entity schema. This setting guarantees that Dataplex Universal Catalog will not change schema fields.",
 "type": "boolean"
 }
 },
diff --git a/googleapiclient/discovery_cache/documents/digitalassetlinks.v1.json b/googleapiclient/discovery_cache/documents/digitalassetlinks.v1.json
index 7c7af1461ca..8ecc1244812 100644
--- a/googleapiclient/discovery_cache/documents/digitalassetlinks.v1.json
+++ b/googleapiclient/discovery_cache/documents/digitalassetlinks.v1.json
@@ -210,7 +210,7 @@
 }
 }
 },
-"revision": "20250405",
+"revision": "20250802",
 "rootUrl": "https://digitalassetlinks.googleapis.com/",
 "schemas": {
 "AndroidAppAsset": {
@@ -337,7 +337,7 @@
 "type": "string"
 },
 "errorCode": {
-"description": "Error codes that describe the result of the Check operation.",
+"description": "Error codes that describe the result of the Check operation. NOTE: Error codes may be populated even when `linked` is true. The error codes do not necessarily imply that the request failed, but rather, specify any errors encountered in the statements file(s) which may or may not impact whether the server determines the requested source and target to be linked.",
 "items": {
 "enum": [
 "ERROR_CODE_UNSPECIFIED",
diff --git a/googleapiclient/discovery_cache/documents/driveactivity.v2.json b/googleapiclient/discovery_cache/documents/driveactivity.v2.json
index 27115c48941..6aab3d0b5d2 100644
--- a/googleapiclient/discovery_cache/documents/driveactivity.v2.json
+++ b/googleapiclient/discovery_cache/documents/driveactivity.v2.json
@@ -132,7 +132,7 @@
 }
 }
 },
-"revision": "20250517",
+"revision": "20250805",
 "rootUrl": "https://driveactivity.googleapis.com/",
 "schemas": {
 "Action": {
@@ -1135,7 +1135,9 @@
 "DIRECT_SHARING",
 "ITEM_DUPLICATION",
 "DRIVE_FILE_STREAM",
-"FILE_ORGANIZER_CAN_SHARE_FOLDERS"
+"FILE_ORGANIZER_CAN_SHARE_FOLDERS",
+"READERS_CAN_DOWNLOAD",
+"WRITERS_CAN_DOWNLOAD"
 ],
 "enumDescriptions": [
 "The feature which changed restriction settings was not available.",
@@ -1143,7 +1145,9 @@
 "When restricted, this prevents direct sharing of individual items.",
 "When restricted, this prevents actions like copy, download, and print that might result in uncontrolled duplicates of items. Now deprecated in favor of READERS_CAN_DOWNLOAD.",
 "When restricted, this prevents use of Drive File Stream.",
-"When restricted, this limits sharing of folders to managers only."
+"When restricted, this limits sharing of folders to managers only.",
+"When restricted, this prevents actions like copy, download, and print for readers. This is the same as ITEM_DUPLICATION.",
+"When restricted, this prevents actions like copy, download, and print for writers."
 ],
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/drivelabels.v2.json b/googleapiclient/discovery_cache/documents/drivelabels.v2.json
index 941195bd7c4..db669811a53 100644
--- a/googleapiclient/discovery_cache/documents/drivelabels.v2.json
+++ b/googleapiclient/discovery_cache/documents/drivelabels.v2.json
@@ -117,14 +117,14 @@
 "labels": {
 "methods": {
 "create": {
-"description": "Creates a new Label.",
+"description": "Creates a label. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label).",
 "flatPath": "v2/labels",
 "httpMethod": "POST",
 "id": "drivelabels.labels.create",
 "parameterOrder": [],
 "parameters": {
 "languageCode": {
-"description": "The BCP-47 language code to use for evaluating localized Field labels in response. When not specified, values in the default configured language will be used.",
+"description": "The BCP-47 language code to use for evaluating localized field labels in response. When not specified, values in the default configured language will be used.",
 "location": "query",
 "type": "string"
 },
@@ -147,7 +147,7 @@
 ]
 },
 "delete": {
-"description": "Permanently deletes a Label and related metadata on Drive Items. Once deleted, the Label and related Drive item metadata will be deleted. Only draft Labels, and disabled Labels may be deleted.",
+"description": "Permanently deletes a label and related metadata on Drive items. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Once deleted, the label and related Drive item metadata will be deleted. Only draft labels and disabled labels may be deleted.",
 "flatPath": "v2/labels/{labelsId}",
 "httpMethod": "DELETE",
 "id": "drivelabels.labels.delete",
@@ -163,12 +163,12 @@
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 },
 "writeControl.requiredRevisionId": {
-"description": "The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.",
+"description": "The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.",
 "location": "query",
 "type": "string"
 }
@@ -183,7 +183,7 @@
 ]
 },
 "delta": {
-"description": "Updates a single Label by applying a set of update requests resulting in a new draft revision. The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive Items.",
+"description": "Updates a single label by applying a set of update requests resulting in a new draft revision. For more information, see [Update a label](https://developers.google.com/workspace/drive/labels/guides/update-label). The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive items.",
 "flatPath": "v2/labels/{labelsId}:delta",
 "httpMethod": "POST",
 "id": "drivelabels.labels.delta",
@@ -192,7 +192,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Label to update.",
+"description": "Required. The resource name of the label to update.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -212,7 +212,7 @@
 ]
 },
 "disable": {
-"description": "Disable a published Label. Disabling a Label will result in a new disabled published revision based on the current published revision. If there is a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.",
+"description": "Disable a published label. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Disabling a label will result in a new disabled published revision based on the current published revision. If there's a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.",
 "flatPath": "v2/labels/{labelsId}:disable",
 "httpMethod": "POST",
 "id": "drivelabels.labels.disable",
@@ -241,7 +241,7 @@
 ]
 },
 "enable": {
-"description": "Enable a disabled Label and restore it to its published state. This will result in a new published revision based on the current disabled published revision. If there is an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.",
+"description": "Enable a disabled label and restore it to its published state. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). This will result in a new published revision based on the current disabled published revision. If there's an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.",
 "flatPath": "v2/labels/{labelsId}:enable",
 "httpMethod": "POST",
 "id": "drivelabels.labels.enable",
@@ -270,7 +270,7 @@
 ]
 },
 "get": {
-"description": "Get a label by its resource name. Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.",
+"description": "Get a label by its resource name. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label). Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.",
 "flatPath": "v2/labels/{labelsId}",
 "httpMethod": "GET",
 "id": "drivelabels.labels.get",
@@ -321,14 +321,14 @@
 ]
 },
 "list": {
-"description": "List labels.",
+"description": "List labels. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label).",
 "flatPath": "v2/labels",
 "httpMethod": "GET",
 "id": "drivelabels.labels.list",
 "parameterOrder": [],
 "parameters": {
 "customer": {
-"description": "The customer to scope this list request to. For example: \"customers/abcd1234\". If unset, will return all labels within the current customer.",
+"description": "The customer to scope this list request to. For example: `customers/abcd1234`. If unset, will return all labels within the current customer.",
 "location": "query",
 "type": "string"
 },
@@ -338,7 +338,7 @@
 "type": "string"
 },
 "minimumRole": {
-"description": "Specifies the level of access the user must have on the returned Labels. The minimum role a user must have on a label. Defaults to `READER`.",
+"description": "Specifies the level of access the user must have on the returned labels. The minimum role a user must have on a label. Defaults to `READER`.",
 "enum": [
 "LABEL_ROLE_UNSPECIFIED",
 "READER",
@@ -373,7 +373,7 @@
 "type": "boolean"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. This will return all Labels within the customer.",
+"description": "Set to `true` in order to use the user's admin credentials. This will return all labels within the customer.",
 "location": "query",
 "type": "boolean"
 },
@@ -403,7 +403,7 @@
 ]
 },
 "publish": {
-"description": "Publish all draft changes to the Label. Once published, the Label may not return to its draft state. See `google.apps.drive.labels.v2.Lifecycle` for more information. Publishing a Label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the Label will be rejected. For example, the following changes to a Label will be rejected after the Label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * Field.FieldType cannot be changed. * Changes to Field validation options cannot reject something that was previously accepted. * Reducing the max entries.",
+"description": "Publish all draft changes to the label. Once published, the label may not return to its draft state. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label). Publishing a label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label will be rejected. For example, the following changes to a label will be rejected after the label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * `Field.FieldType` cannot be changed. * Changes to field validation options cannot reject something that was previously accepted. * Reducing the maximum entries.",
 "flatPath": "v2/labels/{labelsId}:publish",
 "httpMethod": "POST",
 "id": "drivelabels.labels.publish",
@@ -432,7 +432,7 @@
 ]
 },
 "updateLabelCopyMode": {
-"description": "Updates a Label's `CopyMode`. Changes to this policy are not revisioned, do not require publishing, and take effect immediately.",
+"description": "Updates a label's `CopyMode`. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately.",
 "flatPath": "v2/labels/{labelsId}:updateLabelCopyMode",
 "httpMethod": "POST",
 "id": "drivelabels.labels.updateLabelCopyMode",
@@ -441,7 +441,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Label to update.",
+"description": "Required. The resource name of the label to update.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -461,7 +461,7 @@
 ]
 },
 "updateLabelEnabledAppSettings": {
-"description": "Updates a Label's EabledAppSettings. Enabling a Label in a Workspace Application allows it to be used in that application. This change is not revisioned, does not require publishing, and takes effect immediately.",
+"description": "Updates a label's `EnabledAppSettings`. Enabling a label in a Google Workspace app allows it to be used in that app. This change isn't revisioned, doesn't require publishing, and takes effect immediately.",
 "flatPath": "v2/labels/{labelsId}:updateLabelEnabledAppSettings",
 "httpMethod": "POST",
 "id": "drivelabels.labels.updateLabelEnabledAppSettings",
@@ -470,7 +470,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Label to update. The resource name of the Label to update.",
+"description": "Required. The resource name of the label to update. The resource name of the label to update.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -486,7 +486,7 @@
 }
 },
 "updatePermissions": {
-"description": "Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2/labels/{labelsId}/permissions",
 "httpMethod": "PATCH",
 "id": "drivelabels.labels.updatePermissions",
@@ -495,14 +495,14 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name.",
+"description": "Required. The parent label resource name.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -524,7 +524,7 @@
 "locks": {
 "methods": {
 "list": {
-"description": "Lists the LabelLocks on a Label.",
+"description": "Lists the label locks on a label.",
 "flatPath": "v2/labels/{labelsId}/locks",
 "httpMethod": "GET",
 "id": "drivelabels.labels.locks.list",
@@ -533,7 +533,7 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "Maximum number of Locks to return per page. Default: 100. Max: 200.",
+"description": "Maximum number of locks to return per page. Default: 100. Max: 200.",
 "format": "int32",
 "location": "query",
 "type": "integer"
@@ -544,7 +544,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Label on which Locks are applied. Format: labels/{label}",
+"description": "Required. Label on which locks are applied. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -567,7 +567,7 @@
 "permissions": {
 "methods": {
 "batchDelete": {
-"description": "Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2/labels/{labelsId}/permissions:batchDelete",
 "httpMethod": "POST",
 "id": "drivelabels.labels.permissions.batchDelete",
@@ -576,7 +576,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name shared by all permissions being deleted. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Required. The parent label resource name shared by all permissions being deleted. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -596,7 +596,7 @@
 ]
 },
 "batchUpdate": {
-"description": "Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2/labels/{labelsId}/permissions:batchUpdate",
 "httpMethod": "POST",
 "id": "drivelabels.labels.permissions.batchUpdate",
@@ -605,7 +605,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name shared by all permissions being updated. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Required. The parent label resource name shared by all permissions being updated. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -625,7 +625,7 @@
 ]
 },
 "create": {
-"description": "Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2/labels/{labelsId}/permissions",
 "httpMethod": "POST",
 "id": "drivelabels.labels.permissions.create",
@@ -634,14 +634,14 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name on the Label Permission is created. Format: labels/{label}",
+"description": "Required. The parent label resource name on the label permission is created. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -659,7 +659,7 @@
 ]
 },
 "delete": {
-"description": "Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2/labels/{labelsId}/permissions/{permissionsId}",
 "httpMethod": "DELETE",
 "id": "drivelabels.labels.permissions.delete",
@@ -668,14 +668,14 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Label Permission resource name.",
+"description": "Required. Label permission resource name.",
 "location": "path",
 "pattern": "^labels/[^/]+/permissions/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -690,7 +690,7 @@
 ]
 },
 "list": {
-"description": "Lists a Label's permissions.",
+"description": "Lists a label's permissions.",
 "flatPath": "v2/labels/{labelsId}/permissions",
 "httpMethod": "GET",
 "id": "drivelabels.labels.permissions.list",
@@ -710,14 +710,14 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The parent Label resource name on which Label Permission are listed. Format: labels/{label}",
+"description": "Required. The parent label resource name on which label permissions are listed. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -738,7 +738,7 @@
 "revisions": {
 "methods": {
 "updatePermissions": {
-"description": "Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2/labels/{labelsId}/revisions/{revisionsId}/permissions",
 "httpMethod": "PATCH",
 "id": "drivelabels.labels.revisions.updatePermissions",
@@ -747,14 +747,14 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name.",
+"description": "Required. The parent label resource name.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -776,7 +776,7 @@
 "locks": {
 "methods": {
 "list": {
-"description": "Lists the LabelLocks on a Label.",
+"description": "Lists the label locks on a label.",
 "flatPath": "v2/labels/{labelsId}/revisions/{revisionsId}/locks",
 "httpMethod": "GET",
 "id": "drivelabels.labels.revisions.locks.list",
@@ -785,7 +785,7 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "Maximum number of Locks to return per page. Default: 100. Max: 200.",
+"description": "Maximum number of locks to return per page. Default: 100. Max: 200.",
 "format": "int32",
 "location": "query",
 "type": "integer"
@@ -796,7 +796,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Label on which Locks are applied. Format: labels/{label}",
+"description": "Required. Label on which locks are applied. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
@@ -819,7 +819,7 @@
 "permissions": {
 "methods": {
 "batchDelete": {
-"description": "Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2/labels/{labelsId}/revisions/{revisionsId}/permissions:batchDelete",
 "httpMethod": "POST",
 "id": "drivelabels.labels.revisions.permissions.batchDelete",
@@ -828,7 +828,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name shared by all permissions being deleted. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Required. The parent label resource name shared by all permissions being deleted. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
@@ -848,7 +848,7 @@
 ]
 },
 "batchUpdate": {
-"description": "Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2/labels/{labelsId}/revisions/{revisionsId}/permissions:batchUpdate",
 "httpMethod": "POST",
 "id": "drivelabels.labels.revisions.permissions.batchUpdate",
@@ -857,7 +857,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name shared by all permissions being updated. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Required. The parent label resource name shared by all permissions being updated. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
@@ -877,7 +877,7 @@
 ]
 },
 "create": {
-"description": "Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2/labels/{labelsId}/revisions/{revisionsId}/permissions",
 "httpMethod": "POST",
 "id": "drivelabels.labels.revisions.permissions.create",
@@ -886,14 +886,14 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name on the Label Permission is created. Format: labels/{label}",
+"description": "Required. The parent label resource name on the label permission is created. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -911,7 +911,7 @@
 ]
 },
 "delete": {
-"description": "Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2/labels/{labelsId}/revisions/{revisionsId}/permissions/{permissionsId}",
 "httpMethod": "DELETE",
 "id": "drivelabels.labels.revisions.permissions.delete",
@@ -920,14 +920,14 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Label Permission resource name.",
+"description": "Required. Label permission resource name.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+/permissions/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -942,7 +942,7 @@
 ]
 },
 "list": {
-"description": "Lists a Label's permissions.",
+"description": "Lists a label's permissions.",
 "flatPath": "v2/labels/{labelsId}/revisions/{revisionsId}/permissions",
 "httpMethod": "GET",
 "id": "drivelabels.labels.revisions.permissions.list",
@@ -962,14 +962,14 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The parent Label resource name on which Label Permission are listed. Format: labels/{label}",
+"description": "Required. The parent label resource name on which label permissions are listed. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -994,14 +994,14 @@
 "limits": {
 "methods": {
 "getLabel": {
-"description": "Get the constraints on the structure of a Label; such as, the maximum number of Fields allowed and maximum length of the label title.",
+"description": "Get the constraints on the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.",
 "flatPath": "v2/limits/label",
 "httpMethod": "GET",
 "id": "drivelabels.limits.getLabel",
 "parameterOrder": [],
 "parameters": {
 "name": {
-"description": "Required. Label revision resource name Must be: \"limits/label\"",
+"description": "Required. Label revision resource name must be: \"limits/label\".",
 "location": "query",
 "type": "string"
 }
@@ -1031,7 +1031,7 @@
 ],
 "parameters": {
 "customer": {
-"description": "The customer to scope this request to. For example: \"customers/abcd1234\". If unset, will return settings within the current customer.",
+"description": "The customer to scope this request to. For example: `customers/abcd1234`. If unset, it will return settings within the current customer.",
 "location": "query",
 "type": "string"
 },
@@ -1057,7 +1057,7 @@
 }
 }
 },
-"revision": "20250602",
+"revision": "20250807",
 "rootUrl": "https://drivelabels.googleapis.com/",
 "schemas": {
 "GoogleAppsDriveLabelsV2BadgeColors": {
@@ -1099,7 +1099,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2BatchDeleteLabelPermissionsRequest": {
-"description": "Deletes one of more Label Permissions.",
+"description": "Deletes one or more label permissions.",
 "id": "GoogleAppsDriveLabelsV2BatchDeleteLabelPermissionsRequest",
 "properties": {
 "requests": {
@@ -1110,14 +1110,14 @@
 "type": "array"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the DeleteLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `DeleteLabelPermissionRequest` messages must either be empty or match this field.",
 "type": "boolean"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2BatchUpdateLabelPermissionsRequest": {
-"description": "Updates one or more Label Permissions.",
+"description": "Updates one or more label permissions.",
 "id": "GoogleAppsDriveLabelsV2BatchUpdateLabelPermissionsRequest",
 "properties": {
 "requests": {
@@ -1128,14 +1128,14 @@
 "type": "array"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the UpdateLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.",
 "type": "boolean"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2BatchUpdateLabelPermissionsResponse": {
-"description": "Response for updating one or more Label Permissions.",
+"description": "Response for updating one or more label permissions.",
 "id": "GoogleAppsDriveLabelsV2BatchUpdateLabelPermissionsResponse",
 "properties": {
 "permissions": {
@@ -1149,52 +1149,52 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DateLimits": {
-"description": "Limits for date Field type.",
+"description": "Limits for date field type.",
 "id": "GoogleAppsDriveLabelsV2DateLimits",
 "properties": {
 "maxValue": {
 "$ref": "GoogleTypeDate",
-"description": "Maximum value for the date Field type."
+"description": "Maximum value for the date field type."
 },
 "minValue": {
 "$ref": "GoogleTypeDate",
-"description": "Minimum value for the date Field type."
+"description": "Minimum value for the date field type."
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeleteLabelPermissionRequest": {
-"description": "Deletes a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Deletes a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "id": "GoogleAppsDriveLabelsV2DeleteLabelPermissionRequest",
 "properties": {
 "name": {
-"description": "Required. Label Permission resource name.",
+"description": "Required. Label permission resource name.",
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequest": {
-"description": "The set of requests for updating aspects of a Label. If any request is not valid, no requests will be applied.",
+"description": "The set of requests for updating aspects of a label. If any request isn't valid, no requests will be applied.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequest",
 "properties": {
 "languageCode": {
-"description": "The BCP-47 language code to use for evaluating localized Field labels when `include_label_in_response` is `true`.",
+"description": "The BCP-47 language code to use for evaluating localized field labels when `include_label_in_response` is `true`.",
 "type": "string"
 },
 "requests": {
-"description": "A list of updates to apply to the Label. Requests will be applied in the order they are specified.",
+"description": "A list of updates to apply to the label. Requests will be applied in the order they are specified.",
 "items": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestRequest"
 },
 "type": "array"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "view": {
@@ -1217,7 +1217,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestCreateFieldRequest": {
-"description": "Request to create a Field within a Label.",
+"description": "Request to create a field within a label.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestCreateFieldRequest",
 "properties": {
 "field": {
@@ -1228,37 +1228,37 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestCreateSelectionChoiceRequest": {
-"description": "Request to create a Selection Choice.",
+"description": "Request to create a selection choice.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestCreateSelectionChoiceRequest",
 "properties": {
 "choice": {
 "$ref": "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoice",
-"description": "Required. The Choice to create."
+"description": "Required. The choice to create."
 },
 "fieldId": {
-"description": "Required. The Selection Field in which a Choice will be created.",
+"description": "Required. The selection field in which a choice will be created.",
 "type": "string"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDeleteFieldRequest": {
-"description": "Request to delete the Field.",
+"description": "Request to delete the field.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDeleteFieldRequest",
 "properties": {
 "id": {
-"description": "Required. ID of the Field to delete.",
+"description": "Required. ID of the field to delete.",
 "type": "string"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDeleteSelectionChoiceRequest": {
-"description": "Request to delete a Choice.",
+"description": "Request to delete a choice.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDeleteSelectionChoiceRequest",
 "properties": {
 "fieldId": {
-"description": "Required. The Selection Field from which a Choice will be deleted.",
+"description": "Required. The selection field from which a choice will be deleted.",
 "type": "string"
 },
 "id": {
@@ -1269,19 +1269,19 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDisableFieldRequest": {
-"description": "Request to disable the Field.",
+"description": "Request to disable the field.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDisableFieldRequest",
 "properties": {
 "disabledPolicy": {
 "$ref": "GoogleAppsDriveLabelsV2LifecycleDisabledPolicy",
-"description": "Required. Field Disabled Policy."
+"description": "Required. Field disabled policy."
 },
 "id": {
-"description": "Required. Key of the Field to disable.",
+"description": "Required. Key of the field to disable.",
 "type": "string"
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 }
@@ -1289,7 +1289,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDisableSelectionChoiceRequest": {
-"description": "Request to disable a Choice.",
+"description": "Request to disable a choice.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDisableSelectionChoiceRequest",
 "properties": {
 "disabledPolicy": {
@@ -1297,7 +1297,7 @@
 "description": "Required. The disabled policy to update."
 },
 "fieldId": {
-"description": "Required. The Selection Field in which a Choice will be disabled.",
+"description": "Required. The selection field in which a choice will be disabled.",
 "type": "string"
 },
 "id": {
@@ -1305,7 +1305,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 }
@@ -1313,22 +1313,22 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestEnableFieldRequest": {
-"description": "Request to enable the Field.",
+"description": "Request to enable the field.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestEnableFieldRequest",
 "properties": {
 "id": {
-"description": "Required. ID of the Field to enable.",
+"description": "Required. ID of the field to enable.",
 "type": "string"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestEnableSelectionChoiceRequest": {
-"description": "Request to enable a Choice.",
+"description": "Request to enable a choice.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestEnableSelectionChoiceRequest",
 "properties": {
 "fieldId": {
-"description": "Required. The Selection Field in which a Choice will be enabled.",
+"description": "Required. The selection field in which a choice will be enabled.",
 "type": "string"
 },
 "id": {
@@ -1339,74 +1339,74 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestRequest": {
-"description": "A single kind of update to apply to a Label.",
+"description": "A single kind of update to apply to a label.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestRequest",
 "properties": {
 "createField": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestCreateFieldRequest",
-"description": "Creates a new Field."
+"description": "Creates a field."
 },
 "createSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestCreateSelectionChoiceRequest",
-"description": "Creates Choice within a Selection field."
+"description": "Create a choice within a selection field."
 },
 "deleteField": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDeleteFieldRequest",
-"description": "Deletes a Field from the label."
+"description": "Deletes a field from the label."
 },
 "deleteSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDeleteSelectionChoiceRequest",
-"description": "Delete a Choice within a Selection Field."
+"description": "Delete a choice within a selection field."
 },
 "disableField": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDisableFieldRequest",
-"description": "Disables the Field."
+"description": "Disables the field."
 },
 "disableSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDisableSelectionChoiceRequest",
-"description": "Disable a Choice within a Selection Field."
+"description": "Disable a choice within a selection field."
 },
 "enableField": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestEnableFieldRequest",
-"description": "Enables the Field."
+"description": "Enables the field."
 },
 "enableSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestEnableSelectionChoiceRequest",
-"description": "Enable a Choice within a Selection Field."
+"description": "Enable a choice within a selection field."
 },
 "updateField": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateFieldPropertiesRequest",
-"description": "Updates basic properties of a Field."
+"description": "Updates basic properties of a field."
 },
 "updateFieldType": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateFieldTypeRequest",
-"description": "Update Field type and/or type options."
+"description": "Update field type and/or type options."
 },
 "updateLabel": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateLabelPropertiesRequest",
-"description": "Updates the Label properties."
+"description": "Updates the label properties."
 },
 "updateSelectionChoiceProperties": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateSelectionChoicePropertiesRequest",
-"description": "Update a Choice properties within a Selection Field."
+"description": "Update a choice property within a selection field."
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateFieldPropertiesRequest": {
-"description": "Request to update Field properties.",
+"description": "Request to update field properties.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateFieldPropertiesRequest",
 "properties": {
 "id": {
-"description": "Required. The Field to update.",
+"description": "Required. The field to update.",
 "type": "string"
 },
 "properties": {
 "$ref": "GoogleAppsDriveLabelsV2FieldProperties",
-"description": "Required. Basic Field properties."
+"description": "Required. Basic field properties."
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 }
@@ -1414,7 +1414,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateFieldTypeRequest": {
-"description": "Request to change the type of a Field.",
+"description": "Request to change the type of a field.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateFieldTypeRequest",
 "properties": {
 "dateOptions": {
@@ -1422,7 +1422,7 @@
 "description": "Update field to Date."
 },
 "id": {
-"description": "Required. The Field to update.",
+"description": "Required. The field to update.",
 "type": "string"
 },
 "integerOptions": {
@@ -1438,7 +1438,7 @@
 "description": "Update field to Text."
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root of `type_options` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root of `type_options` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 },
@@ -1450,7 +1450,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateLabelPropertiesRequest": {
-"description": "Updates basic properties of a Label.",
+"description": "Updates basic properties of a label.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateLabelPropertiesRequest",
 "properties": {
 "properties": {
@@ -1458,7 +1458,7 @@
 "description": "Required. Label properties to update."
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `label_properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `label_properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 }
@@ -1466,23 +1466,23 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateSelectionChoicePropertiesRequest": {
-"description": "Request to update a Choice properties.",
+"description": "Request to update a choice property.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateSelectionChoicePropertiesRequest",
 "properties": {
 "fieldId": {
-"description": "Required. The Selection Field to update.",
+"description": "Required. The selection field to update.",
 "type": "string"
 },
 "id": {
-"description": "Required. The Choice to update.",
+"description": "Required. The choice to update.",
 "type": "string"
 },
 "properties": {
 "$ref": "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceProperties",
-"description": "Required. The Choice properties to update."
+"description": "Required. The choice properties to update."
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 }
@@ -1490,7 +1490,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponse": {
-"description": "Response for Label update.",
+"description": "Response for label update.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponse",
 "properties": {
 "responses": {
@@ -1502,13 +1502,13 @@
 },
 "updatedLabel": {
 "$ref": "GoogleAppsDriveLabelsV2Label",
-"description": "The label after updates were applied. This is only set if [BatchUpdateLabelResponse2.include_label_in_response] is `true` and there were no errors."
+"description": "The label after updates were applied. This is only set if `include_label_in_response` is `true` and there were no errors."
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseCreateFieldResponse": {
-"description": "Response following Field create.",
+"description": "Response following field create.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseCreateFieldResponse",
 "properties": {
 "id": {
@@ -1524,52 +1524,52 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseCreateSelectionChoiceResponse": {
-"description": "Response following Selection Choice create.",
+"description": "Response following selection choice create.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseCreateSelectionChoiceResponse",
 "properties": {
 "fieldId": {
-"description": "The server-generated id of the field.",
+"description": "The server-generated ID of the field.",
 "type": "string"
 },
 "id": {
-"description": "The server-generated ID of the created choice within the Field",
+"description": "The server-generated ID of the created choice within the field.",
 "type": "string"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDeleteFieldResponse": {
-"description": "Response following Field delete.",
+"description": "Response following field delete.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDeleteFieldResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDeleteSelectionChoiceResponse": {
-"description": "Response following Choice delete.",
+"description": "Response following choice delete.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDeleteSelectionChoiceResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDisableFieldResponse": {
-"description": "Response following Field disable.",
+"description": "Response following field disable.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDisableFieldResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDisableSelectionChoiceResponse": {
-"description": "Response following Choice disable.",
+"description": "Response following choice disable.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDisableSelectionChoiceResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseEnableFieldResponse": {
-"description": "Response following Field enable.",
+"description": "Response following field enable.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseEnableFieldResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseEnableSelectionChoiceResponse": {
-"description": "Response following Choice enable.",
+"description": "Response following choice enable.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseEnableSelectionChoiceResponse",
 "properties": {},
 "type": "object"
@@ -1580,57 +1580,57 @@
 "properties": {
 "createField": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseCreateFieldResponse",
-"description": "Creates a new Field."
+"description": "Creates a field."
 },
 "createSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseCreateSelectionChoiceResponse",
-"description": "Creates a new selection list option to add to a Selection Field."
+"description": "Creates a selection list option to add to a selection field."
 },
 "deleteField": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDeleteFieldResponse",
-"description": "Deletes a Field from the label."
+"description": "Deletes a field from the label."
 },
 "deleteSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDeleteSelectionChoiceResponse",
-"description": "Deletes a Choice from a Selection Field."
+"description": "Deletes a choice from a selection field."
 },
 "disableField": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDisableFieldResponse",
-"description": "Disables Field."
+"description": "Disables field."
 },
 "disableSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDisableSelectionChoiceResponse",
-"description": "Disables a Choice within a Selection Field."
+"description": "Disables a choice within a selection field."
 },
 "enableField": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseEnableFieldResponse",
-"description": "Enables Field."
+"description": "Enables field."
 },
 "enableSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseEnableSelectionChoiceResponse",
-"description": "Enables a Choice within a Selection Field."
+"description": "Enables a choice within a selection field."
 },
 "updateField": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateFieldPropertiesResponse",
-"description": "Updates basic properties of a Field."
+"description": "Updates basic properties of a field."
 },
 "updateFieldType": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateFieldTypeResponse",
-"description": "Update Field type and/or type options."
+"description": "Updates field type and/or type options."
 },
 "updateLabel": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateLabelPropertiesResponse",
-"description": "Updated basic properties of a Label."
+"description": "Updates basic properties of a label."
 },
 "updateSelectionChoiceProperties": {
 "$ref": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateSelectionChoicePropertiesResponse",
-"description": "Updates a Choice within a Selection Field."
+"description": "Updates a choice within a selection field."
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateFieldPropertiesResponse": {
-"description": "Response following update to Field properties.",
+"description": "Response following update to field properties.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateFieldPropertiesResponse",
 "properties": {
 "priority": {
@@ -1642,19 +1642,19 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateFieldTypeResponse": {
-"description": "Response following update to Field type.",
+"description": "Response following update to field type.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateFieldTypeResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateLabelPropertiesResponse": {
-"description": "Response following update to Label properties.",
+"description": "Response following update to label properties.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateLabelPropertiesResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateSelectionChoicePropertiesResponse": {
-"description": "Response following update to Selection Choice properties.",
+"description": "Response following update to selection choice properties.",
 "id": "GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateSelectionChoicePropertiesResponse",
 "properties": {
 "priority": {
@@ -1666,7 +1666,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2DisableLabelRequest": {
-"description": "Request to deprecate a published Label.",
+"description": "Request to deprecate a published label.",
 "id": "GoogleAppsDriveLabelsV2DisableLabelRequest",
 "properties": {
 "disabledPolicy": {
@@ -1678,17 +1678,17 @@
 "type": "string"
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "writeControl": {
 "$ref": "GoogleAppsDriveLabelsV2WriteControl",
-"description": "Provides control over how write requests are executed. Defaults to unset, which means last write wins."
+"description": "Provides control over how write requests are executed. Defaults to unset, which means the last write wins."
 }
 },
 "type": "object"
@@ -1702,12 +1702,12 @@
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "writeControl": {
 "$ref": "GoogleAppsDriveLabelsV2WriteControl",
-"description": "Provides control over how write requests are executed. Defaults to unset, which means last write wins."
+"description": "Provides control over how write requests are executed. Defaults to unset, which means the last write wins."
 }
 },
 "type": "object"
@@ -1753,7 +1753,7 @@
 "readOnly": true
 },
 "id": {
-"description": "Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`",
+"description": "Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.",
 "readOnly": true,
 "type": "string"
 },
@@ -1768,7 +1768,7 @@
 },
 "lockStatus": {
 "$ref": "GoogleAppsDriveLabelsV2LockStatus",
-"description": "Output only. The LockStatus of this field.",
+"description": "Output only. The `LockStatus` of this field.",
 "readOnly": true
 },
 "properties": {
@@ -1914,47 +1914,47 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2FieldLimits": {
-"description": "Field constants governing the structure of a Field; such as, the maximum title length, minimum and maximum field values or length, etc.",
+"description": "Field constants governing the structure of a field; such as, the maximum title length, minimum and maximum field values or length, etc.",
 "id": "GoogleAppsDriveLabelsV2FieldLimits",
 "properties": {
 "dateLimits": {
 "$ref": "GoogleAppsDriveLabelsV2DateLimits",
-"description": "Date Field limits."
+"description": "Date field limits."
 },
 "integerLimits": {
 "$ref": "GoogleAppsDriveLabelsV2IntegerLimits",
-"description": "Integer Field limits."
+"description": "Integer field limits."
 },
 "longTextLimits": {
 "$ref": "GoogleAppsDriveLabelsV2LongTextLimits",
-"description": "Long text Field limits."
+"description": "Long text field limits."
 },
 "maxDescriptionLength": {
-"description": "Limits for Field description, also called help text.",
+"description": "Limits for field description, also called help text.",
 "format": "int32",
 "type": "integer"
 },
 "maxDisplayNameLength": {
-"description": "Limits for Field title.",
+"description": "Limits for field title.",
 "format": "int32",
 "type": "integer"
 },
 "maxIdLength": {
-"description": "Max length for the id.",
+"description": "Maximum length for the id.",
 "format": "int32",
 "type": "integer"
 },
 "selectionLimits": {
 "$ref": "GoogleAppsDriveLabelsV2SelectionLimits",
-"description": "Selection Field limits."
+"description": "Selection field limits."
 },
 "textLimits": {
 "$ref": "GoogleAppsDriveLabelsV2TextLimits",
-"description": "The relevant limits for the specified Field.Type. Text Field limits."
+"description": "The relevant limits for the specified Field.Type. Text field limits."
 },
 "userLimits": {
 "$ref": "GoogleAppsDriveLabelsV2UserLimits",
-"description": "User Field limits."
+"description": "User field limits."
 }
 },
 "type": "object"
@@ -2078,7 +2078,7 @@
 },
 "lockStatus": {
 "$ref": "GoogleAppsDriveLabelsV2LockStatus",
-"description": "Output only. The LockStatus of this choice.",
+"description": "Output only. The `LockStatus` of this choice.",
 "readOnly": true
 },
 "properties": {
@@ -2243,16 +2243,16 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2IntegerLimits": {
-"description": "Limits for integer Field type.",
+"description": "Limits for integer field type.",
 "id": "GoogleAppsDriveLabelsV2IntegerLimits",
 "properties": {
 "maxValue": {
-"description": "Maximum value for an integer Field type.",
+"description": "Maximum value for an integer field type.",
 "format": "int64",
 "type": "string"
 },
 "minValue": {
-"description": "Minimum value for an integer Field type.",
+"description": "Minimum value for an integer field type.",
 "format": "int64",
 "type": "string"
 }
@@ -2285,19 +2285,19 @@
 "readOnly": true
 },
 "customer": {
-"description": "Output only. The customer this label belongs to. For example: \"customers/123abc789.\"",
+"description": "Output only. The customer this label belongs to. For example: `customers/123abc789`.",
 "readOnly": true,
 "type": "string"
 },
 "disableTime": {
-"description": "Output only. The time this label was disabled. This value has no meaning when the label is not disabled.",
+"description": "Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
 "disabler": {
 "$ref": "GoogleAppsDriveLabelsV2UserInfo",
-"description": "Output only. The user who disabled this label. This value has no meaning when the label is not disabled.",
+"description": "Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.",
 "readOnly": true
 },
 "displayHints": {
@@ -2307,7 +2307,7 @@
 },
 "enabledAppSettings": {
 "$ref": "GoogleAppsDriveLabelsV2LabelEnabledAppSettings",
-"description": "Optional. The EnabledAppSettings for this Label."
+"description": "Optional. The `EnabledAppSettings` for this Label."
 },
 "fields": {
 "description": "List of fields in descending priority order.",
@@ -2317,7 +2317,7 @@
 "type": "array"
 },
 "id": {
-"description": "Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`",
+"description": "Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.",
 "readOnly": true,
 "type": "string"
 },
@@ -2348,7 +2348,7 @@
 },
 "lockStatus": {
 "$ref": "GoogleAppsDriveLabelsV2LockStatus",
-"description": "Output only. The LockStatus of this label.",
+"description": "Output only. The `LockStatus` of this label.",
 "readOnly": true
 },
 "name": {
@@ -2361,14 +2361,14 @@
 "description": "Required. The basic properties of the label."
 },
 "publishTime": {
-"description": "Output only. The time this label was published. This value has no meaning when the label is not published.",
+"description": "Output only. The time this label was published. This value has no meaning when the label isn't published.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
 "publisher": {
 "$ref": "GoogleAppsDriveLabelsV2UserInfo",
-"description": "Output only. The user who published this label. This value has no meaning when the label is not published.",
+"description": "Output only. The user who published this label. This value has no meaning when the label isn't published.>>",
 "readOnly": true
 },
 "revisionCreateTime": {
@@ -2383,7 +2383,7 @@
 "readOnly": true
 },
 "revisionId": {
-"description": "Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`",
+"description": "Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.",
 "readOnly": true,
 "type": "string"
 },
@@ -2428,7 +2428,7 @@
 ],
 "enumDescriptions": [
 "Copy mode unspecified.",
-"The applied label and field values are not copied by default when the Drive item it's applied to is copied.",
+"The applied label and field values aren't copied by default when the Drive item it's applied to is copied.",
 "The applied label and field values are always copied when the Drive item it's applied to is copied. Only admins can use this mode.",
 "The applied label and field values are copied if the label is appliable by the user making the copy."
 ],
@@ -2438,7 +2438,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2LabelDisplayHints": {
-"description": "UI display hints for rendering the label.",
+"description": "The UI display hints for rendering the label.",
 "id": "GoogleAppsDriveLabelsV2LabelDisplayHints",
 "properties": {
 "disabled": {
@@ -2450,7 +2450,7 @@
 "type": "boolean"
 },
 "priority": {
-"description": "Order to display label in a list.",
+"description": "The order to display labels in a list.",
 "format": "int64",
 "type": "string"
 },
@@ -2462,11 +2462,11 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2LabelEnabledAppSettings": {
-"description": "Describes the Workspace apps in which the Label can be used.",
+"description": "Describes the Google Workspace apps in which the label can be used.",
 "id": "GoogleAppsDriveLabelsV2LabelEnabledAppSettings",
 "properties": {
 "enabledApps": {
-"description": "Optional. The list of Apps where the Label can be used.",
+"description": "Optional. The list of apps where the label can be used.",
 "items": {
 "$ref": "GoogleAppsDriveLabelsV2LabelEnabledAppSettingsEnabledApp"
 },
@@ -2476,11 +2476,11 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2LabelEnabledAppSettingsEnabledApp": {
-"description": "An App where the Label can be used.",
+"description": "An app where the label can be used.",
 "id": "GoogleAppsDriveLabelsV2LabelEnabledAppSettingsEnabledApp",
 "properties": {
 "app": {
-"description": "Optional. The name of the App.",
+"description": "Optional. The name of the app.",
 "enum": [
 "APP_UNSPECIFIED",
 "DRIVE",
@@ -2488,7 +2488,7 @@
 ],
 "enumDescriptions": [
 "Unspecified",
-"Drive.",
+"Drive",
 "Gmail"
 ],
 "type": "string"
@@ -2497,15 +2497,15 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2LabelLimits": {
-"description": "Label constraints governing the structure of a Label; such as, the maximum number of Fields allowed and maximum length of the label title.",
+"description": "Label constraints governing the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.",
 "id": "GoogleAppsDriveLabelsV2LabelLimits",
 "properties": {
 "fieldLimits": {
 "$ref": "GoogleAppsDriveLabelsV2FieldLimits",
-"description": "The limits for Fields."
+"description": "The limits for fields."
 },
 "maxDeletedFields": {
-"description": "The maximum number of published Fields that can be deleted.",
+"description": "The maximum number of published fields that can be deleted.",
 "format": "int32",
 "type": "integer"
 },
@@ -2520,7 +2520,7 @@
 "type": "integer"
 },
 "maxFields": {
-"description": "The maximum number of Fields allowed within the label.",
+"description": "The maximum number of fields allowed within the label.",
 "format": "int32",
 "type": "integer"
 },
@@ -2537,46 +2537,46 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2LabelLock": {
-"description": "A Lock that can be applied to a Label, Field, or Choice.",
+"description": "A lock that can be applied to a label, field, or choice.",
 "id": "GoogleAppsDriveLabelsV2LabelLock",
 "properties": {
 "capabilities": {
 "$ref": "GoogleAppsDriveLabelsV2LabelLockCapabilities",
-"description": "Output only. The user's capabilities on this LabelLock.",
+"description": "Output only. The user's capabilities on this label lock.",
 "readOnly": true
 },
 "choiceId": {
-"description": "The ID of the Selection Field Choice that should be locked. If present, `field_id` must also be present.",
+"description": "The ID of the selection field choice that should be locked. If present, `field_id` must also be present.",
 "type": "string"
 },
 "createTime": {
-"description": "Output only. The time this LabelLock was created.",
+"description": "Output only. The time this label lock was created.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
 "creator": {
 "$ref": "GoogleAppsDriveLabelsV2UserInfo",
-"description": "Output only. The user whose credentials were used to create the LabelLock. This will not be present if no user was responsible for creating the LabelLock.",
+"description": "Output only. The user whose credentials were used to create the label lock. Not present if no user was responsible for creating the label lock.",
 "readOnly": true
 },
 "deleteTime": {
-"description": "Output only. A timestamp indicating when this LabelLock was scheduled for deletion. This will be present only if this LabelLock is in the DELETING state.",
+"description": "Output only. A timestamp indicating when this label lock was scheduled for deletion. Present only if this label lock is in the `DELETING` state.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
 "fieldId": {
-"description": "The ID of the Field that should be locked. Empty if the whole Label should be locked.",
+"description": "The ID of the field that should be locked. Empty if the whole label should be locked.",
 "type": "string"
 },
 "name": {
-"description": "Output only. Resource name of this LabelLock.",
+"description": "Output only. Resource name of this label lock.",
 "readOnly": true,
 "type": "string"
 },
 "state": {
-"description": "Output only. This LabelLock's state.",
+"description": "Output only. This label lock's state.",
 "enum": [
 "STATE_UNSPECIFIED",
 "ACTIVE",
@@ -2584,8 +2584,8 @@
 ],
 "enumDescriptions": [
 "Unknown state.",
-"The LabelLock is active and is being enforced by the server.",
-"The LabelLock is being deleted. The LabelLock will continue to be enforced by the server until it has been fully removed."
+"The label lock is active and is being enforced by the server.",
+"The label lock is being deleted. The label lock will continue to be enforced by the server until it has been fully removed."
 ],
 "readOnly": true,
 "type": "string"
@@ -2594,7 +2594,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2LabelLockCapabilities": {
-"description": "A description of a user's capabilities on a LabelLock.",
+"description": "A description of a user's capabilities on a label lock.",
 "id": "GoogleAppsDriveLabelsV2LabelLockCapabilities",
 "properties": {
 "canViewPolicy": {
@@ -2609,11 +2609,11 @@
 "id": "GoogleAppsDriveLabelsV2LabelPermission",
 "properties": {
 "audience": {
-"description": "Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.",
+"description": "Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.",
 "type": "string"
 },
 "email": {
-"description": "Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.",
+"description": "Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.",
 "type": "string"
 },
 "group": {
@@ -2688,7 +2688,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2Lifecycle": {
-"description": "The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published\u2014Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled\u2014When disabled, the configured `DisabledPolicy` takes effect.",
+"description": "The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect.",
 "id": "GoogleAppsDriveLabelsV2Lifecycle",
 "properties": {
 "disabledPolicy": {
@@ -2738,11 +2738,11 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2ListLabelLocksResponse": {
-"description": "The response to a ListLabelLocksRequest.",
+"description": "The response to a `ListLabelLocksRequest`.",
 "id": "GoogleAppsDriveLabelsV2ListLabelLocksResponse",
 "properties": {
 "labelLocks": {
-"description": "LabelLocks.",
+"description": "Label locks.",
 "items": {
 "$ref": "GoogleAppsDriveLabelsV2LabelLock"
 },
@@ -2756,7 +2756,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2ListLabelPermissionsResponse": {
-"description": "Response for listing the permissions on a Label.",
+"description": "Response for listing the permissions on a label.",
 "id": "GoogleAppsDriveLabelsV2ListLabelPermissionsResponse",
 "properties": {
 "labelPermissions": {
@@ -2774,7 +2774,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2ListLabelsResponse": {
-"description": "Response for listing Labels.",
+"description": "Response for listing labels.",
 "id": "GoogleAppsDriveLabelsV2ListLabelsResponse",
 "properties": {
 "labels": {
@@ -2792,11 +2792,11 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2ListLimits": {
-"description": "Limits for list-variant of a Field type.",
+"description": "Limits for list-variant of a field type.",
 "id": "GoogleAppsDriveLabelsV2ListLimits",
 "properties": {
 "maxEntries": {
-"description": "Maximum number of values allowed for the Field type.",
+"description": "Maximum number of values allowed for the field type.",
 "format": "int32",
 "type": "integer"
 }
@@ -2808,7 +2808,7 @@
 "id": "GoogleAppsDriveLabelsV2LockStatus",
 "properties": {
 "locked": {
-"description": "Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.",
+"description": "Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.",
 "readOnly": true,
 "type": "boolean"
 }
@@ -2816,16 +2816,16 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2LongTextLimits": {
-"description": "Limits for long text Field type.",
+"description": "Limits for long text field type.",
 "id": "GoogleAppsDriveLabelsV2LongTextLimits",
 "properties": {
 "maxLength": {
-"description": "Maximum length allowed for a long text Field type.",
+"description": "Maximum length allowed for a long text field type.",
 "format": "int32",
 "type": "integer"
 },
 "minLength": {
-"description": "Minimum length allowed for a long text Field type.",
+"description": "Minimum length allowed for a long text field type.",
 "format": "int32",
 "type": "integer"
 }
@@ -2841,26 +2841,26 @@
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "writeControl": {
 "$ref": "GoogleAppsDriveLabelsV2WriteControl",
-"description": "Provides control over how write requests are executed. Defaults to unset, which means last write wins."
+"description": "Provides control over how write requests are executed. Defaults to unset, which means the last write wins."
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2SelectionLimits": {
-"description": "Limits for selection Field type.",
+"description": "Limits for selection field type.",
 "id": "GoogleAppsDriveLabelsV2SelectionLimits",
 "properties": {
 "listLimits": {
 "$ref": "GoogleAppsDriveLabelsV2ListLimits",
-"description": "Limits for list-variant of a Field type."
+"description": "Limits for list-variant of a field type."
 },
 "maxChoices": {
-"description": "The max number of choices.",
+"description": "Maximum number of choices.",
 "format": "int32",
 "type": "integer"
 },
@@ -2875,7 +2875,7 @@
 "type": "integer"
 },
 "maxIdLength": {
-"description": "Maximum ID length for a selection options.",
+"description": "Maximum ID length for a selection option.",
 "format": "int32",
 "type": "integer"
 }
@@ -2883,16 +2883,16 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2TextLimits": {
-"description": "Limits for text Field type.",
+"description": "Limits for text field type.",
 "id": "GoogleAppsDriveLabelsV2TextLimits",
 "properties": {
 "maxLength": {
-"description": "Maximum length allowed for a text Field type.",
+"description": "Maximum length allowed for a text field type.",
 "format": "int32",
 "type": "integer"
 },
 "minLength": {
-"description": "Minimum length allowed for a text Field type.",
+"description": "Minimum length allowed for a text field type.",
 "format": "int32",
 "type": "integer"
 }
@@ -2900,11 +2900,11 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2UpdateLabelCopyModeRequest": {
-"description": "Request to update the `CopyMode` of the given Label. Changes to this policy are not revisioned, do not require publishing, and take effect immediately. \\",
+"description": "Request to update the `CopyMode` of the given label. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately. \\",
 "id": "GoogleAppsDriveLabelsV2UpdateLabelCopyModeRequest",
 "properties": {
 "copyMode": {
-"description": "Required. Indicates how the applied Label, and Field values should be copied when a Drive item is copied.",
+"description": "Required. Indicates how the applied label and field values should be copied when a Drive item is copied.",
 "enum": [
 "COPY_MODE_UNSPECIFIED",
 "DO_NOT_COPY",
@@ -2913,7 +2913,7 @@
 ],
 "enumDescriptions": [
 "Copy mode unspecified.",
-"The applied label and field values are not copied by default when the Drive item it's applied to is copied.",
+"The applied label and field values aren't copied by default when the Drive item it's applied to is copied.",
 "The applied label and field values are always copied when the Drive item it's applied to is copied. Only admins can use this mode.",
 "The applied label and field values are copied if the label is appliable by the user making the copy."
 ],
@@ -2924,7 +2924,7 @@
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "view": {
@@ -2943,19 +2943,19 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2UpdateLabelEnabledAppSettingsRequest": {
-"description": "Request to update the `EnabledAppSettings` of the given Label. This change is not revisioned, does not require publishing, and takes effect immediately. \\",
+"description": "Request to update the `EnabledAppSettings` of the given label. This change is not revisioned, doesn't require publishing, and takes effect immediately. \\",
 "id": "GoogleAppsDriveLabelsV2UpdateLabelEnabledAppSettingsRequest",
 "properties": {
 "enabledAppSettings": {
 "$ref": "GoogleAppsDriveLabelsV2LabelEnabledAppSettings",
-"description": "Required. The new `EnabledAppSettings` value for the Label."
+"description": "Required. The new `EnabledAppSettings` value for the label."
 },
 "languageCode": {
 "description": "Optional. The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.",
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Optional. Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Optional. Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "view": {
@@ -2974,19 +2974,19 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2UpdateLabelPermissionRequest": {
-"description": "Updates a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "id": "GoogleAppsDriveLabelsV2UpdateLabelPermissionRequest",
 "properties": {
 "labelPermission": {
 "$ref": "GoogleAppsDriveLabelsV2LabelPermission",
-"description": "Required. The permission to create or update on the Label."
+"description": "Required. The permission to create or update on the label."
 },
 "parent": {
-"description": "Required. The parent Label resource name.",
+"description": "Required. The parent label resource name.",
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 }
 },
@@ -3007,12 +3007,12 @@
 "type": "boolean"
 },
 "canCreateAdminLabels": {
-"description": "Output only. Whether the user is allowed to create new admin labels.",
+"description": "Output only. Whether the user is allowed to create admin labels.",
 "readOnly": true,
 "type": "boolean"
 },
 "canCreateSharedLabels": {
-"description": "Output only. Whether the user is allowed to create new shared labels.",
+"description": "Output only. Whether the user is allowed to create shared labels.",
 "readOnly": true,
 "type": "boolean"
 },
@@ -3029,7 +3029,7 @@
 "id": "GoogleAppsDriveLabelsV2UserInfo",
 "properties": {
 "person": {
-"description": "The identifier for this user that can be used with the People API to get more information. For example, people/12345678.",
+"description": "The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.",
 "type": "string"
 }
 },
@@ -3041,7 +3041,7 @@
 "properties": {
 "listLimits": {
 "$ref": "GoogleAppsDriveLabelsV2ListLimits",
-"description": "Limits for list-variant of a Field type."
+"description": "Limits for list-variant of a field type."
 }
 },
 "type": "object"
@@ -3051,7 +3051,7 @@
 "id": "GoogleAppsDriveLabelsV2WriteControl",
 "properties": {
 "requiredRevisionId": {
-"description": "The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.",
+"description": "The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.",
 "type": "string"
 }
 },
diff --git a/googleapiclient/discovery_cache/documents/drivelabels.v2beta.json b/googleapiclient/discovery_cache/documents/drivelabels.v2beta.json
index 6d9de09981f..2521ab08892 100644
--- a/googleapiclient/discovery_cache/documents/drivelabels.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/drivelabels.v2beta.json
@@ -117,14 +117,14 @@
 "labels": {
 "methods": {
 "create": {
-"description": "Creates a new Label.",
+"description": "Creates a label. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label).",
 "flatPath": "v2beta/labels",
 "httpMethod": "POST",
 "id": "drivelabels.labels.create",
 "parameterOrder": [],
 "parameters": {
 "languageCode": {
-"description": "The BCP-47 language code to use for evaluating localized Field labels in response. When not specified, values in the default configured language will be used.",
+"description": "The BCP-47 language code to use for evaluating localized field labels in response. When not specified, values in the default configured language will be used.",
 "location": "query",
 "type": "string"
 },
@@ -147,7 +147,7 @@
 ]
 },
 "delete": {
-"description": "Permanently deletes a Label and related metadata on Drive Items. Once deleted, the Label and related Drive item metadata will be deleted. Only draft Labels, and disabled Labels may be deleted.",
+"description": "Permanently deletes a label and related metadata on Drive items. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Once deleted, the label and related Drive item metadata will be deleted. Only draft labels and disabled labels may be deleted.",
 "flatPath": "v2beta/labels/{labelsId}",
 "httpMethod": "DELETE",
 "id": "drivelabels.labels.delete",
@@ -163,12 +163,12 @@
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 },
 "writeControl.requiredRevisionId": {
-"description": "The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.",
+"description": "The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.",
 "location": "query",
 "type": "string"
 }
@@ -183,7 +183,7 @@
 ]
 },
 "delta": {
-"description": "Updates a single Label by applying a set of update requests resulting in a new draft revision. The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive Items.",
+"description": "Updates a single label by applying a set of update requests resulting in a new draft revision. For more information, see [Update a label](https://developers.google.com/workspace/drive/labels/guides/update-label). The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive items.",
 "flatPath": "v2beta/labels/{labelsId}:delta",
 "httpMethod": "POST",
 "id": "drivelabels.labels.delta",
@@ -192,7 +192,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Label to update.",
+"description": "Required. The resource name of the label to update.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -212,7 +212,7 @@
 ]
 },
 "disable": {
-"description": "Disable a published Label. Disabling a Label will result in a new disabled published revision based on the current published revision. If there is a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.",
+"description": "Disable a published label. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Disabling a label will result in a new disabled published revision based on the current published revision. If there's a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.",
 "flatPath": "v2beta/labels/{labelsId}:disable",
 "httpMethod": "POST",
 "id": "drivelabels.labels.disable",
@@ -241,7 +241,7 @@
 ]
 },
 "enable": {
-"description": "Enable a disabled Label and restore it to its published state. This will result in a new published revision based on the current disabled published revision. If there is an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.",
+"description": "Enable a disabled label and restore it to its published state. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). This will result in a new published revision based on the current disabled published revision. If there's an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.",
 "flatPath": "v2beta/labels/{labelsId}:enable",
 "httpMethod": "POST",
 "id": "drivelabels.labels.enable",
@@ -270,7 +270,7 @@
 ]
 },
 "get": {
-"description": "Get a label by its resource name. Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.",
+"description": "Get a label by its resource name. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label). Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.",
 "flatPath": "v2beta/labels/{labelsId}",
 "httpMethod": "GET",
 "id": "drivelabels.labels.get",
@@ -321,14 +321,14 @@
 ]
 },
 "list": {
-"description": "List labels.",
+"description": "List labels. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label).",
 "flatPath": "v2beta/labels",
 "httpMethod": "GET",
 "id": "drivelabels.labels.list",
 "parameterOrder": [],
 "parameters": {
 "customer": {
-"description": "The customer to scope this list request to. For example: \"customers/abcd1234\". If unset, will return all labels within the current customer.",
+"description": "The customer to scope this list request to. For example: `customers/abcd1234`. If unset, will return all labels within the current customer.",
 "location": "query",
 "type": "string"
 },
@@ -338,7 +338,7 @@
 "type": "string"
 },
 "minimumRole": {
-"description": "Specifies the level of access the user must have on the returned Labels. The minimum role a user must have on a label. Defaults to `READER`.",
+"description": "Specifies the level of access the user must have on the returned labels. The minimum role a user must have on a label. Defaults to `READER`.",
 "enum": [
 "LABEL_ROLE_UNSPECIFIED",
 "READER",
@@ -373,7 +373,7 @@
 "type": "boolean"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. This will return all Labels within the customer.",
+"description": "Set to `true` in order to use the user's admin credentials. This will return all labels within the customer.",
 "location": "query",
 "type": "boolean"
 },
@@ -403,7 +403,7 @@
 ]
 },
 "publish": {
-"description": "Publish all draft changes to the Label. Once published, the Label may not return to its draft state. See `google.apps.drive.labels.v2.Lifecycle` for more information. Publishing a Label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the Label will be rejected. For example, the following changes to a Label will be rejected after the Label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * Field.FieldType cannot be changed. * Changes to Field validation options cannot reject something that was previously accepted. * Reducing the max entries.",
+"description": "Publish all draft changes to the label. Once published, the label may not return to its draft state. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label). Publishing a label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label will be rejected. For example, the following changes to a label will be rejected after the label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * `Field.FieldType` cannot be changed. * Changes to field validation options cannot reject something that was previously accepted. * Reducing the maximum entries.",
 "flatPath": "v2beta/labels/{labelsId}:publish",
 "httpMethod": "POST",
 "id": "drivelabels.labels.publish",
@@ -432,7 +432,7 @@
 ]
 },
 "updateLabelCopyMode": {
-"description": "Updates a Label's `CopyMode`. Changes to this policy are not revisioned, do not require publishing, and take effect immediately.",
+"description": "Updates a label's `CopyMode`. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately.",
 "flatPath": "v2beta/labels/{labelsId}:updateLabelCopyMode",
 "httpMethod": "POST",
 "id": "drivelabels.labels.updateLabelCopyMode",
@@ -441,7 +441,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Label to update.",
+"description": "Required. The resource name of the label to update.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -461,7 +461,7 @@
 ]
 },
 "updateLabelEnabledAppSettings": {
-"description": "Updates a Label's EabledAppSettings. Enabling a Label in a Workspace Application allows it to be used in that application. This change is not revisioned, does not require publishing, and takes effect immediately.",
+"description": "Updates a label's `EnabledAppSettings`. Enabling a label in a Google Workspace app allows it to be used in that app. This change isn't revisioned, doesn't require publishing, and takes effect immediately.",
 "flatPath": "v2beta/labels/{labelsId}:updateLabelEnabledAppSettings",
 "httpMethod": "POST",
 "id": "drivelabels.labels.updateLabelEnabledAppSettings",
@@ -470,7 +470,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Label to update. The resource name of the Label to update.",
+"description": "Required. The resource name of the label to update. The resource name of the label to update.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -486,7 +486,7 @@
 }
 },
 "updatePermissions": {
-"description": "Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2beta/labels/{labelsId}/permissions",
 "httpMethod": "PATCH",
 "id": "drivelabels.labels.updatePermissions",
@@ -495,14 +495,14 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name.",
+"description": "Required. The parent label resource name.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -524,7 +524,7 @@
 "locks": {
 "methods": {
 "list": {
-"description": "Lists the LabelLocks on a Label.",
+"description": "Lists the label locks on a label.",
 "flatPath": "v2beta/labels/{labelsId}/locks",
 "httpMethod": "GET",
 "id": "drivelabels.labels.locks.list",
@@ -533,7 +533,7 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "Maximum number of Locks to return per page. Default: 100. Max: 200.",
+"description": "Maximum number of locks to return per page. Default: 100. Max: 200.",
 "format": "int32",
 "location": "query",
 "type": "integer"
@@ -544,7 +544,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Label on which Locks are applied. Format: labels/{label}",
+"description": "Required. Label on which locks are applied. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -567,7 +567,7 @@
 "permissions": {
 "methods": {
 "batchDelete": {
-"description": "Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2beta/labels/{labelsId}/permissions:batchDelete",
 "httpMethod": "POST",
 "id": "drivelabels.labels.permissions.batchDelete",
@@ -576,7 +576,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name shared by all permissions being deleted. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Required. The parent label resource name shared by all permissions being deleted. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -596,7 +596,7 @@
 ]
 },
 "batchUpdate": {
-"description": "Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2beta/labels/{labelsId}/permissions:batchUpdate",
 "httpMethod": "POST",
 "id": "drivelabels.labels.permissions.batchUpdate",
@@ -605,7 +605,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name shared by all permissions being updated. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Required. The parent label resource name shared by all permissions being updated. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
@@ -625,7 +625,7 @@
 ]
 },
 "create": {
-"description": "Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2beta/labels/{labelsId}/permissions",
 "httpMethod": "POST",
 "id": "drivelabels.labels.permissions.create",
@@ -634,14 +634,14 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name on the Label Permission is created. Format: labels/{label}",
+"description": "Required. The parent label resource name on the label permission is created. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -659,7 +659,7 @@
 ]
 },
 "delete": {
-"description": "Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2beta/labels/{labelsId}/permissions/{permissionsId}",
 "httpMethod": "DELETE",
 "id": "drivelabels.labels.permissions.delete",
@@ -668,14 +668,14 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Label Permission resource name.",
+"description": "Required. Label permission resource name.",
 "location": "path",
 "pattern": "^labels/[^/]+/permissions/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -690,7 +690,7 @@
 ]
 },
 "list": {
-"description": "Lists a Label's permissions.",
+"description": "Lists a label's permissions.",
 "flatPath": "v2beta/labels/{labelsId}/permissions",
 "httpMethod": "GET",
 "id": "drivelabels.labels.permissions.list",
@@ -710,14 +710,14 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The parent Label resource name on which Label Permission are listed. Format: labels/{label}",
+"description": "Required. The parent label resource name on which label permissions are listed. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -738,7 +738,7 @@
 "revisions": {
 "methods": {
 "updatePermissions": {
-"description": "Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions",
 "httpMethod": "PATCH",
 "id": "drivelabels.labels.revisions.updatePermissions",
@@ -747,14 +747,14 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name.",
+"description": "Required. The parent label resource name.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -776,7 +776,7 @@
 "locks": {
 "methods": {
 "list": {
-"description": "Lists the LabelLocks on a Label.",
+"description": "Lists the label locks on a label.",
 "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/locks",
 "httpMethod": "GET",
 "id": "drivelabels.labels.revisions.locks.list",
@@ -785,7 +785,7 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "Maximum number of Locks to return per page. Default: 100. Max: 200.",
+"description": "Maximum number of locks to return per page. Default: 100. Max: 200.",
 "format": "int32",
 "location": "query",
 "type": "integer"
@@ -796,7 +796,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Label on which Locks are applied. Format: labels/{label}",
+"description": "Required. Label on which locks are applied. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
@@ -819,7 +819,7 @@
 "permissions": {
 "methods": {
 "batchDelete": {
-"description": "Deletes Label permissions. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions:batchDelete",
 "httpMethod": "POST",
 "id": "drivelabels.labels.revisions.permissions.batchDelete",
@@ -828,7 +828,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name shared by all permissions being deleted. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Required. The parent label resource name shared by all permissions being deleted. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
@@ -848,7 +848,7 @@
 ]
 },
 "batchUpdate": {
-"description": "Updates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions:batchUpdate",
 "httpMethod": "POST",
 "id": "drivelabels.labels.revisions.permissions.batchUpdate",
@@ -857,7 +857,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name shared by all permissions being updated. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Required. The parent label resource name shared by all permissions being updated. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
@@ -877,7 +877,7 @@
 ]
 },
 "create": {
-"description": "Updates a Label's permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions",
 "httpMethod": "POST",
 "id": "drivelabels.labels.revisions.permissions.create",
@@ -886,14 +886,14 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The parent Label resource name on the Label Permission is created. Format: labels/{label}",
+"description": "Required. The parent label resource name on the label permission is created. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -911,7 +911,7 @@
 ]
 },
 "delete": {
-"description": "Deletes a Label's permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions/{permissionsId}",
 "httpMethod": "DELETE",
 "id": "drivelabels.labels.revisions.permissions.delete",
@@ -920,14 +920,14 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Label Permission resource name.",
+"description": "Required. Label permission resource name.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+/permissions/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -942,7 +942,7 @@
 ]
 },
 "list": {
-"description": "Lists a Label's permissions.",
+"description": "Lists a label's permissions.",
 "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions",
 "httpMethod": "GET",
 "id": "drivelabels.labels.revisions.permissions.list",
@@ -962,14 +962,14 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The parent Label resource name on which Label Permission are listed. Format: labels/{label}",
+"description": "Required. The parent label resource name on which label permissions are listed. Format: `labels/{label}`.",
 "location": "path",
 "pattern": "^labels/[^/]+/revisions/[^/]+$",
 "required": true,
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "location": "query",
 "type": "boolean"
 }
@@ -994,14 +994,14 @@
 "limits": {
 "methods": {
 "getLabel": {
-"description": "Get the constraints on the structure of a Label; such as, the maximum number of Fields allowed and maximum length of the label title.",
+"description": "Get the constraints on the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.",
 "flatPath": "v2beta/limits/label",
 "httpMethod": "GET",
 "id": "drivelabels.limits.getLabel",
 "parameterOrder": [],
 "parameters": {
 "name": {
-"description": "Required. Label revision resource name Must be: \"limits/label\"",
+"description": "Required. Label revision resource name must be: \"limits/label\".",
 "location": "query",
 "type": "string"
 }
@@ -1031,7 +1031,7 @@
 ],
 "parameters": {
 "customer": {
-"description": "The customer to scope this request to. For example: \"customers/abcd1234\". If unset, will return settings within the current customer.",
+"description": "The customer to scope this request to. For example: `customers/abcd1234`. If unset, it will return settings within the current customer.",
 "location": "query",
 "type": "string"
 },
@@ -1057,7 +1057,7 @@
 }
 }
 },
-"revision": "20250602",
+"revision": "20250807",
 "rootUrl": "https://drivelabels.googleapis.com/",
 "schemas": {
 "GoogleAppsDriveLabelsV2betaBadgeColors": {
@@ -1099,7 +1099,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaBatchDeleteLabelPermissionsRequest": {
-"description": "Deletes one of more Label Permissions.",
+"description": "Deletes one or more label permissions.",
 "id": "GoogleAppsDriveLabelsV2betaBatchDeleteLabelPermissionsRequest",
 "properties": {
 "requests": {
@@ -1110,14 +1110,14 @@
 "type": "array"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the DeleteLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `DeleteLabelPermissionRequest` messages must either be empty or match this field.",
 "type": "boolean"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsRequest": {
-"description": "Updates one or more Label Permissions.",
+"description": "Updates one or more label permissions.",
 "id": "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsRequest",
 "properties": {
 "requests": {
@@ -1128,14 +1128,14 @@
 "type": "array"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the use_admin_access field in the UpdateLabelPermissionRequest messages must either be empty or match this field.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.",
 "type": "boolean"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsResponse": {
-"description": "Response for updating one or more Label Permissions.",
+"description": "Response for updating one or more label permissions.",
 "id": "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsResponse",
 "properties": {
 "permissions": {
@@ -1149,52 +1149,52 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDateLimits": {
-"description": "Limits for date Field type.",
+"description": "Limits for date field type.",
 "id": "GoogleAppsDriveLabelsV2betaDateLimits",
 "properties": {
 "maxValue": {
 "$ref": "GoogleTypeDate",
-"description": "Maximum value for the date Field type."
+"description": "Maximum value for the date field type."
 },
 "minValue": {
 "$ref": "GoogleTypeDate",
-"description": "Minimum value for the date Field type."
+"description": "Minimum value for the date field type."
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeleteLabelPermissionRequest": {
-"description": "Deletes a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Deletes a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "id": "GoogleAppsDriveLabelsV2betaDeleteLabelPermissionRequest",
 "properties": {
 "name": {
-"description": "Required. Label Permission resource name.",
+"description": "Required. Label permission resource name.",
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequest": {
-"description": "The set of requests for updating aspects of a Label. If any request is not valid, no requests will be applied.",
+"description": "The set of requests for updating aspects of a label. If any request isn't valid, no requests will be applied.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequest",
 "properties": {
 "languageCode": {
-"description": "The BCP-47 language code to use for evaluating localized Field labels when `include_label_in_response` is `true`.",
+"description": "The BCP-47 language code to use for evaluating localized field labels when `include_label_in_response` is `true`.",
 "type": "string"
 },
 "requests": {
-"description": "A list of updates to apply to the Label. Requests will be applied in the order they are specified.",
+"description": "A list of updates to apply to the label. Requests will be applied in the order they are specified.",
 "items": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestRequest"
 },
 "type": "array"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "view": {
@@ -1217,7 +1217,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateFieldRequest": {
-"description": "Request to create a Field within a Label.",
+"description": "Request to create a field within a label.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateFieldRequest",
 "properties": {
 "field": {
@@ -1228,37 +1228,37 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateSelectionChoiceRequest": {
-"description": "Request to create a Selection Choice.",
+"description": "Request to create a selection choice.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateSelectionChoiceRequest",
 "properties": {
 "choice": {
 "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoice",
-"description": "Required. The Choice to create."
+"description": "Required. The choice to create."
 },
 "fieldId": {
-"description": "Required. The Selection Field in which a Choice will be created.",
+"description": "Required. The selection field in which a choice will be created.",
 "type": "string"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteFieldRequest": {
-"description": "Request to delete the Field.",
+"description": "Request to delete the field.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteFieldRequest",
 "properties": {
 "id": {
-"description": "Required. ID of the Field to delete.",
+"description": "Required. ID of the field to delete.",
 "type": "string"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteSelectionChoiceRequest": {
-"description": "Request to delete a Choice.",
+"description": "Request to delete a choice.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteSelectionChoiceRequest",
 "properties": {
 "fieldId": {
-"description": "Required. The Selection Field from which a Choice will be deleted.",
+"description": "Required. The selection field from which a choice will be deleted.",
 "type": "string"
 },
 "id": {
@@ -1269,19 +1269,19 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableFieldRequest": {
-"description": "Request to disable the Field.",
+"description": "Request to disable the field.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableFieldRequest",
 "properties": {
 "disabledPolicy": {
 "$ref": "GoogleAppsDriveLabelsV2betaLifecycleDisabledPolicy",
-"description": "Required. Field Disabled Policy."
+"description": "Required. Field disabled policy."
 },
 "id": {
-"description": "Required. Key of the Field to disable.",
+"description": "Required. Key of the field to disable.",
 "type": "string"
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 }
@@ -1289,7 +1289,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableSelectionChoiceRequest": {
-"description": "Request to disable a Choice.",
+"description": "Request to disable a choice.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableSelectionChoiceRequest",
 "properties": {
 "disabledPolicy": {
@@ -1297,7 +1297,7 @@
 "description": "Required. The disabled policy to update."
 },
 "fieldId": {
-"description": "Required. The Selection Field in which a Choice will be disabled.",
+"description": "Required. The selection field in which a choice will be disabled.",
 "type": "string"
 },
 "id": {
@@ -1305,7 +1305,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 }
@@ -1313,22 +1313,22 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableFieldRequest": {
-"description": "Request to enable the Field.",
+"description": "Request to enable the field.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableFieldRequest",
 "properties": {
 "id": {
-"description": "Required. ID of the Field to enable.",
+"description": "Required. ID of the field to enable.",
 "type": "string"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableSelectionChoiceRequest": {
-"description": "Request to enable a Choice.",
+"description": "Request to enable a choice.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableSelectionChoiceRequest",
 "properties": {
 "fieldId": {
-"description": "Required. The Selection Field in which a Choice will be enabled.",
+"description": "Required. The selection field in which a choice will be enabled.",
 "type": "string"
 },
 "id": {
@@ -1339,74 +1339,74 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestRequest": {
-"description": "A single kind of update to apply to a Label.",
+"description": "A single kind of update to apply to a label.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestRequest",
 "properties": {
 "createField": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateFieldRequest",
-"description": "Creates a new Field."
+"description": "Creates a field."
 },
 "createSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateSelectionChoiceRequest",
-"description": "Creates Choice within a Selection field."
+"description": "Create a choice within a selection field."
 },
 "deleteField": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteFieldRequest",
-"description": "Deletes a Field from the label."
+"description": "Deletes a field from the label."
 },
 "deleteSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteSelectionChoiceRequest",
-"description": "Delete a Choice within a Selection Field."
+"description": "Delete a choice within a selection field."
 },
 "disableField": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableFieldRequest",
-"description": "Disables the Field."
+"description": "Disables the field."
 },
 "disableSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableSelectionChoiceRequest",
-"description": "Disable a Choice within a Selection Field."
+"description": "Disable a choice within a selection field."
 },
 "enableField": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableFieldRequest",
-"description": "Enables the Field."
+"description": "Enables the field."
 },
 "enableSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableSelectionChoiceRequest",
-"description": "Enable a Choice within a Selection Field."
+"description": "Enable a choice within a selection field."
 },
 "updateField": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldPropertiesRequest",
-"description": "Updates basic properties of a Field."
+"description": "Updates basic properties of a field."
 },
 "updateFieldType": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldTypeRequest",
-"description": "Update Field type and/or type options."
+"description": "Update field type and/or type options."
 },
 "updateLabel": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateLabelPropertiesRequest",
-"description": "Updates the Label properties."
+"description": "Updates the label properties."
 },
 "updateSelectionChoiceProperties": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateSelectionChoicePropertiesRequest",
-"description": "Update a Choice properties within a Selection Field."
+"description": "Update a choice property within a selection field."
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldPropertiesRequest": {
-"description": "Request to update Field properties.",
+"description": "Request to update field properties.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldPropertiesRequest",
 "properties": {
 "id": {
-"description": "Required. The Field to update.",
+"description": "Required. The field to update.",
 "type": "string"
 },
 "properties": {
 "$ref": "GoogleAppsDriveLabelsV2betaFieldProperties",
-"description": "Required. Basic Field properties."
+"description": "Required. Basic field properties."
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 }
@@ -1414,7 +1414,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldTypeRequest": {
-"description": "Request to change the type of a Field.",
+"description": "Request to change the type of a field.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldTypeRequest",
 "properties": {
 "dateOptions": {
@@ -1422,7 +1422,7 @@
 "description": "Update field to Date."
 },
 "id": {
-"description": "Required. The Field to update.",
+"description": "Required. The field to update.",
 "type": "string"
 },
 "integerOptions": {
@@ -1438,7 +1438,7 @@
 "description": "Update field to Text."
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root of `type_options` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root of `type_options` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 },
@@ -1450,7 +1450,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateLabelPropertiesRequest": {
-"description": "Updates basic properties of a Label.",
+"description": "Updates basic properties of a label.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateLabelPropertiesRequest",
 "properties": {
 "properties": {
@@ -1458,7 +1458,7 @@
 "description": "Required. Label properties to update."
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `label_properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `label_properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 }
@@ -1466,23 +1466,23 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateSelectionChoicePropertiesRequest": {
-"description": "Request to update a Choice properties.",
+"description": "Request to update a choice property.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateSelectionChoicePropertiesRequest",
 "properties": {
 "fieldId": {
-"description": "Required. The Selection Field to update.",
+"description": "Required. The selection field to update.",
 "type": "string"
 },
 "id": {
-"description": "Required. The Choice to update.",
+"description": "Required. The choice to update.",
 "type": "string"
 },
 "properties": {
 "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties",
-"description": "Required. The Choice properties to update."
+"description": "Required. The choice properties to update."
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 }
@@ -1490,7 +1490,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponse": {
-"description": "Response for Label update.",
+"description": "Response for label update.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponse",
 "properties": {
 "responses": {
@@ -1502,13 +1502,13 @@
 },
 "updatedLabel": {
 "$ref": "GoogleAppsDriveLabelsV2betaLabel",
-"description": "The label after updates were applied. This is only set if [BatchUpdateLabelResponse2.include_label_in_response] is `true` and there were no errors."
+"description": "The label after updates were applied. This is only set if `include_label_in_response` is `true` and there were no errors."
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateFieldResponse": {
-"description": "Response following Field create.",
+"description": "Response following field create.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateFieldResponse",
 "properties": {
 "id": {
@@ -1524,52 +1524,52 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateSelectionChoiceResponse": {
-"description": "Response following Selection Choice create.",
+"description": "Response following selection choice create.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateSelectionChoiceResponse",
 "properties": {
 "fieldId": {
-"description": "The server-generated id of the field.",
+"description": "The server-generated ID of the field.",
 "type": "string"
 },
 "id": {
-"description": "The server-generated ID of the created choice within the Field",
+"description": "The server-generated ID of the created choice within the field.",
 "type": "string"
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteFieldResponse": {
-"description": "Response following Field delete.",
+"description": "Response following field delete.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteFieldResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteSelectionChoiceResponse": {
-"description": "Response following Choice delete.",
+"description": "Response following choice delete.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteSelectionChoiceResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableFieldResponse": {
-"description": "Response following Field disable.",
+"description": "Response following field disable.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableFieldResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableSelectionChoiceResponse": {
-"description": "Response following Choice disable.",
+"description": "Response following choice disable.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableSelectionChoiceResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableFieldResponse": {
-"description": "Response following Field enable.",
+"description": "Response following field enable.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableFieldResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableSelectionChoiceResponse": {
-"description": "Response following Choice enable.",
+"description": "Response following choice enable.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableSelectionChoiceResponse",
 "properties": {},
 "type": "object"
@@ -1580,57 +1580,57 @@
 "properties": {
 "createField": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateFieldResponse",
-"description": "Creates a new Field."
+"description": "Creates a field."
 },
 "createSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateSelectionChoiceResponse",
-"description": "Creates a new selection list option to add to a Selection Field."
+"description": "Creates a selection list option to add to a selection field."
 },
 "deleteField": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteFieldResponse",
-"description": "Deletes a Field from the label."
+"description": "Deletes a field from the label."
 },
 "deleteSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteSelectionChoiceResponse",
-"description": "Deletes a Choice from a Selection Field."
+"description": "Deletes a choice from a selection field."
 },
 "disableField": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableFieldResponse",
-"description": "Disables Field."
+"description": "Disables field."
 },
 "disableSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableSelectionChoiceResponse",
-"description": "Disables a Choice within a Selection Field."
+"description": "Disables a choice within a selection field."
 },
 "enableField": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableFieldResponse",
-"description": "Enables Field."
+"description": "Enables field."
 },
 "enableSelectionChoice": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableSelectionChoiceResponse",
-"description": "Enables a Choice within a Selection Field."
+"description": "Enables a choice within a selection field."
 },
 "updateField": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldPropertiesResponse",
-"description": "Updates basic properties of a Field."
+"description": "Updates basic properties of a field."
 },
 "updateFieldType": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldTypeResponse",
-"description": "Update Field type and/or type options."
+"description": "Updates field type and/or type options."
 },
 "updateLabel": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateLabelPropertiesResponse",
-"description": "Updated basic properties of a Label."
+"description": "Updates basic properties of a label."
 },
 "updateSelectionChoiceProperties": {
 "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateSelectionChoicePropertiesResponse",
-"description": "Updates a Choice within a Selection Field."
+"description": "Updates a choice within a selection field."
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldPropertiesResponse": {
-"description": "Response following update to Field properties.",
+"description": "Response following update to field properties.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldPropertiesResponse",
 "properties": {
 "priority": {
@@ -1642,19 +1642,19 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldTypeResponse": {
-"description": "Response following update to Field type.",
+"description": "Response following update to field type.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldTypeResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateLabelPropertiesResponse": {
-"description": "Response following update to Label properties.",
+"description": "Response following update to label properties.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateLabelPropertiesResponse",
 "properties": {},
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateSelectionChoicePropertiesResponse": {
-"description": "Response following update to Selection Choice properties.",
+"description": "Response following update to selection choice properties.",
 "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateSelectionChoicePropertiesResponse",
 "properties": {
 "priority": {
@@ -1666,7 +1666,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaDisableLabelRequest": {
-"description": "Request to deprecate a published Label.",
+"description": "Request to deprecate a published label.",
 "id": "GoogleAppsDriveLabelsV2betaDisableLabelRequest",
 "properties": {
 "disabledPolicy": {
@@ -1678,17 +1678,17 @@
 "type": "string"
 },
 "updateMask": {
-"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as short-hand for updating every field.",
+"description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.",
 "format": "google-fieldmask",
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "writeControl": {
 "$ref": "GoogleAppsDriveLabelsV2betaWriteControl",
-"description": "Provides control over how write requests are executed. Defaults to unset, which means last write wins."
+"description": "Provides control over how write requests are executed. Defaults to unset, which means the last write wins."
 }
 },
 "type": "object"
@@ -1702,12 +1702,12 @@
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "writeControl": {
 "$ref": "GoogleAppsDriveLabelsV2betaWriteControl",
-"description": "Provides control over how write requests are executed. Defaults to unset, which means last write wins."
+"description": "Provides control over how write requests are executed. Defaults to unset, which means the last write wins."
 }
 },
 "type": "object"
@@ -1753,7 +1753,7 @@
 "readOnly": true
 },
 "id": {
-"description": "Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`",
+"description": "Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`.",
 "readOnly": true,
 "type": "string"
 },
@@ -1768,7 +1768,7 @@
 },
 "lockStatus": {
 "$ref": "GoogleAppsDriveLabelsV2betaLockStatus",
-"description": "Output only. The LockStatus of this field.",
+"description": "Output only. The `LockStatus` of this field.",
 "readOnly": true
 },
 "properties": {
@@ -1914,47 +1914,47 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaFieldLimits": {
-"description": "Field constants governing the structure of a Field; such as, the maximum title length, minimum and maximum field values or length, etc.",
+"description": "Field constants governing the structure of a field; such as, the maximum title length, minimum and maximum field values or length, etc.",
 "id": "GoogleAppsDriveLabelsV2betaFieldLimits",
 "properties": {
 "dateLimits": {
 "$ref": "GoogleAppsDriveLabelsV2betaDateLimits",
-"description": "Date Field limits."
+"description": "Date field limits."
 },
 "integerLimits": {
 "$ref": "GoogleAppsDriveLabelsV2betaIntegerLimits",
-"description": "Integer Field limits."
+"description": "Integer field limits."
 },
 "longTextLimits": {
 "$ref": "GoogleAppsDriveLabelsV2betaLongTextLimits",
-"description": "Long text Field limits."
+"description": "Long text field limits."
 },
 "maxDescriptionLength": {
-"description": "Limits for Field description, also called help text.",
+"description": "Limits for field description, also called help text.",
 "format": "int32",
 "type": "integer"
 },
 "maxDisplayNameLength": {
-"description": "Limits for Field title.",
+"description": "Limits for field title.",
 "format": "int32",
 "type": "integer"
 },
 "maxIdLength": {
-"description": "Max length for the id.",
+"description": "Maximum length for the id.",
 "format": "int32",
 "type": "integer"
 },
 "selectionLimits": {
 "$ref": "GoogleAppsDriveLabelsV2betaSelectionLimits",
-"description": "Selection Field limits."
+"description": "Selection field limits."
 },
 "textLimits": {
 "$ref": "GoogleAppsDriveLabelsV2betaTextLimits",
-"description": "The relevant limits for the specified Field.Type. Text Field limits."
+"description": "The relevant limits for the specified Field.Type. Text field limits."
 },
 "userLimits": {
 "$ref": "GoogleAppsDriveLabelsV2betaUserLimits",
-"description": "User Field limits."
+"description": "User field limits."
 }
 },
 "type": "object"
@@ -2078,7 +2078,7 @@
 },
 "lockStatus": {
 "$ref": "GoogleAppsDriveLabelsV2betaLockStatus",
-"description": "Output only. The LockStatus of this choice.",
+"description": "Output only. The `LockStatus` of this choice.",
 "readOnly": true
 },
 "properties": {
@@ -2243,16 +2243,16 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaIntegerLimits": {
-"description": "Limits for integer Field type.",
+"description": "Limits for integer field type.",
 "id": "GoogleAppsDriveLabelsV2betaIntegerLimits",
 "properties": {
 "maxValue": {
-"description": "Maximum value for an integer Field type.",
+"description": "Maximum value for an integer field type.",
 "format": "int64",
 "type": "string"
 },
 "minValue": {
-"description": "Minimum value for an integer Field type.",
+"description": "Minimum value for an integer field type.",
 "format": "int64",
 "type": "string"
 }
@@ -2285,19 +2285,19 @@
 "readOnly": true
 },
 "customer": {
-"description": "Output only. The customer this label belongs to. For example: \"customers/123abc789.\"",
+"description": "Output only. The customer this label belongs to. For example: `customers/123abc789`.",
 "readOnly": true,
 "type": "string"
 },
 "disableTime": {
-"description": "Output only. The time this label was disabled. This value has no meaning when the label is not disabled.",
+"description": "Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
 "disabler": {
 "$ref": "GoogleAppsDriveLabelsV2betaUserInfo",
-"description": "Output only. The user who disabled this label. This value has no meaning when the label is not disabled.",
+"description": "Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.",
 "readOnly": true
 },
 "displayHints": {
@@ -2307,7 +2307,7 @@
 },
 "enabledAppSettings": {
 "$ref": "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettings",
-"description": "Optional. The EnabledAppSettings for this Label."
+"description": "Optional. The `EnabledAppSettings` for this Label."
 },
 "fields": {
 "description": "List of fields in descending priority order.",
@@ -2317,7 +2317,7 @@
 "type": "array"
 },
 "id": {
-"description": "Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`",
+"description": "Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`.",
 "readOnly": true,
 "type": "string"
 },
@@ -2348,7 +2348,7 @@
 },
 "lockStatus": {
 "$ref": "GoogleAppsDriveLabelsV2betaLockStatus",
-"description": "Output only. The LockStatus of this label.",
+"description": "Output only. The `LockStatus` of this label.",
 "readOnly": true
 },
 "name": {
@@ -2361,14 +2361,14 @@
 "description": "Required. The basic properties of the label."
 },
 "publishTime": {
-"description": "Output only. The time this label was published. This value has no meaning when the label is not published.",
+"description": "Output only. The time this label was published. This value has no meaning when the label isn't published.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
 "publisher": {
 "$ref": "GoogleAppsDriveLabelsV2betaUserInfo",
-"description": "Output only. The user who published this label. This value has no meaning when the label is not published.",
+"description": "Output only. The user who published this label. This value has no meaning when the label isn't published.>>",
 "readOnly": true
 },
 "revisionCreateTime": {
@@ -2383,7 +2383,7 @@
 "readOnly": true
 },
 "revisionId": {
-"description": "Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`",
+"description": "Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`.",
 "readOnly": true,
 "type": "string"
 },
@@ -2428,7 +2428,7 @@
 ],
 "enumDescriptions": [
 "Copy mode unspecified.",
-"The applied label and field values are not copied by default when the Drive item it's applied to is copied.",
+"The applied label and field values aren't copied by default when the Drive item it's applied to is copied.",
 "The applied label and field values are always copied when the Drive item it's applied to is copied. Only admins can use this mode.",
 "The applied label and field values are copied if the label is appliable by the user making the copy."
 ],
@@ -2438,7 +2438,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaLabelDisplayHints": {
-"description": "UI display hints for rendering the label.",
+"description": "The UI display hints for rendering the label.",
 "id": "GoogleAppsDriveLabelsV2betaLabelDisplayHints",
 "properties": {
 "disabled": {
@@ -2450,7 +2450,7 @@
 "type": "boolean"
 },
 "priority": {
-"description": "Order to display label in a list.",
+"description": "The order to display labels in a list.",
 "format": "int64",
 "type": "string"
 },
@@ -2462,11 +2462,11 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettings": {
-"description": "Describes the Workspace apps in which the Label can be used.",
+"description": "Describes the Google Workspace apps in which the label can be used.",
 "id": "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettings",
 "properties": {
 "enabledApps": {
-"description": "Optional. The list of Apps where the Label can be used.",
+"description": "Optional. The list of apps where the label can be used.",
 "items": {
 "$ref": "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettingsEnabledApp"
 },
@@ -2476,11 +2476,11 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettingsEnabledApp": {
-"description": "An App where the Label can be used.",
+"description": "An app where the label can be used.",
 "id": "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettingsEnabledApp",
 "properties": {
 "app": {
-"description": "Optional. The name of the App.",
+"description": "Optional. The name of the app.",
 "enum": [
 "APP_UNSPECIFIED",
 "DRIVE",
@@ -2488,7 +2488,7 @@
 ],
 "enumDescriptions": [
 "Unspecified",
-"Drive.",
+"Drive",
 "Gmail"
 ],
 "type": "string"
@@ -2497,15 +2497,15 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaLabelLimits": {
-"description": "Label constraints governing the structure of a Label; such as, the maximum number of Fields allowed and maximum length of the label title.",
+"description": "Label constraints governing the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.",
 "id": "GoogleAppsDriveLabelsV2betaLabelLimits",
 "properties": {
 "fieldLimits": {
 "$ref": "GoogleAppsDriveLabelsV2betaFieldLimits",
-"description": "The limits for Fields."
+"description": "The limits for fields."
 },
 "maxDeletedFields": {
-"description": "The maximum number of published Fields that can be deleted.",
+"description": "The maximum number of published fields that can be deleted.",
 "format": "int32",
 "type": "integer"
 },
@@ -2520,7 +2520,7 @@
 "type": "integer"
 },
 "maxFields": {
-"description": "The maximum number of Fields allowed within the label.",
+"description": "The maximum number of fields allowed within the label.",
 "format": "int32",
 "type": "integer"
 },
@@ -2537,46 +2537,46 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaLabelLock": {
-"description": "A Lock that can be applied to a Label, Field, or Choice.",
+"description": "A lock that can be applied to a label, field, or choice.",
 "id": "GoogleAppsDriveLabelsV2betaLabelLock",
 "properties": {
 "capabilities": {
 "$ref": "GoogleAppsDriveLabelsV2betaLabelLockCapabilities",
-"description": "Output only. The user's capabilities on this LabelLock.",
+"description": "Output only. The user's capabilities on this label lock.",
 "readOnly": true
 },
 "choiceId": {
-"description": "The ID of the Selection Field Choice that should be locked. If present, `field_id` must also be present.",
+"description": "The ID of the selection field choice that should be locked. If present, `field_id` must also be present.",
 "type": "string"
 },
 "createTime": {
-"description": "Output only. The time this LabelLock was created.",
+"description": "Output only. The time this label lock was created.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
 "creator": {
 "$ref": "GoogleAppsDriveLabelsV2betaUserInfo",
-"description": "Output only. The user whose credentials were used to create the LabelLock. This will not be present if no user was responsible for creating the LabelLock.",
+"description": "Output only. The user whose credentials were used to create the label lock. Not present if no user was responsible for creating the label lock.",
 "readOnly": true
 },
 "deleteTime": {
-"description": "Output only. A timestamp indicating when this LabelLock was scheduled for deletion. This will be present only if this LabelLock is in the DELETING state.",
+"description": "Output only. A timestamp indicating when this label lock was scheduled for deletion. Present only if this label lock is in the `DELETING` state.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
 "fieldId": {
-"description": "The ID of the Field that should be locked. Empty if the whole Label should be locked.",
+"description": "The ID of the field that should be locked. Empty if the whole label should be locked.",
 "type": "string"
 },
 "name": {
-"description": "Output only. Resource name of this LabelLock.",
+"description": "Output only. Resource name of this label lock.",
 "readOnly": true,
 "type": "string"
 },
 "state": {
-"description": "Output only. This LabelLock's state.",
+"description": "Output only. This label lock's state.",
 "enum": [
 "STATE_UNSPECIFIED",
 "ACTIVE",
@@ -2584,8 +2584,8 @@
 ],
 "enumDescriptions": [
 "Unknown state.",
-"The LabelLock is active and is being enforced by the server.",
-"The LabelLock is being deleted. The LabelLock will continue to be enforced by the server until it has been fully removed."
+"The label lock is active and is being enforced by the server.",
+"The label lock is being deleted. The label lock will continue to be enforced by the server until it has been fully removed."
 ],
 "readOnly": true,
 "type": "string"
@@ -2594,7 +2594,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaLabelLockCapabilities": {
-"description": "A description of a user's capabilities on a LabelLock.",
+"description": "A description of a user's capabilities on a label lock.",
 "id": "GoogleAppsDriveLabelsV2betaLabelLockCapabilities",
 "properties": {
 "canViewPolicy": {
@@ -2609,11 +2609,11 @@
 "id": "GoogleAppsDriveLabelsV2betaLabelPermission",
 "properties": {
 "audience": {
-"description": "Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label.",
+"description": "Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.",
 "type": "string"
 },
 "email": {
-"description": "Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.",
+"description": "Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.",
 "type": "string"
 },
 "group": {
@@ -2688,7 +2688,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaLifecycle": {
-"description": "The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * Published\u2014Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled\u2014When disabled, the configured `DisabledPolicy` takes effect.",
+"description": "The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` -> (Deleted) The published and disabled states have some distinct characteristics: * `Published`: Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes aren't permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * `Disabled`: When disabled, the configured `DisabledPolicy` takes effect.",
 "id": "GoogleAppsDriveLabelsV2betaLifecycle",
 "properties": {
 "disabledPolicy": {
@@ -2738,11 +2738,11 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaListLabelLocksResponse": {
-"description": "The response to a ListLabelLocksRequest.",
+"description": "The response to a `ListLabelLocksRequest`.",
 "id": "GoogleAppsDriveLabelsV2betaListLabelLocksResponse",
 "properties": {
 "labelLocks": {
-"description": "LabelLocks.",
+"description": "Label locks.",
 "items": {
 "$ref": "GoogleAppsDriveLabelsV2betaLabelLock"
 },
@@ -2756,7 +2756,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaListLabelPermissionsResponse": {
-"description": "Response for listing the permissions on a Label.",
+"description": "Response for listing the permissions on a label.",
 "id": "GoogleAppsDriveLabelsV2betaListLabelPermissionsResponse",
 "properties": {
 "labelPermissions": {
@@ -2774,7 +2774,7 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaListLabelsResponse": {
-"description": "Response for listing Labels.",
+"description": "Response for listing labels.",
 "id": "GoogleAppsDriveLabelsV2betaListLabelsResponse",
 "properties": {
 "labels": {
@@ -2792,11 +2792,11 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaListLimits": {
-"description": "Limits for list-variant of a Field type.",
+"description": "Limits for list-variant of a field type.",
 "id": "GoogleAppsDriveLabelsV2betaListLimits",
 "properties": {
 "maxEntries": {
-"description": "Maximum number of values allowed for the Field type.",
+"description": "Maximum number of values allowed for the field type.",
 "format": "int32",
 "type": "integer"
 }
@@ -2808,7 +2808,7 @@
 "id": "GoogleAppsDriveLabelsV2betaLockStatus",
 "properties": {
 "locked": {
-"description": "Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.",
+"description": "Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.",
 "readOnly": true,
 "type": "boolean"
 }
@@ -2816,16 +2816,16 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaLongTextLimits": {
-"description": "Limits for long text Field type.",
+"description": "Limits for long text field type.",
 "id": "GoogleAppsDriveLabelsV2betaLongTextLimits",
 "properties": {
 "maxLength": {
-"description": "Maximum length allowed for a long text Field type.",
+"description": "Maximum length allowed for a long text field type.",
 "format": "int32",
 "type": "integer"
 },
 "minLength": {
-"description": "Minimum length allowed for a long text Field type.",
+"description": "Minimum length allowed for a long text field type.",
 "format": "int32",
 "type": "integer"
 }
@@ -2841,26 +2841,26 @@
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "writeControl": {
 "$ref": "GoogleAppsDriveLabelsV2betaWriteControl",
-"description": "Provides control over how write requests are executed. Defaults to unset, which means last write wins."
+"description": "Provides control over how write requests are executed. Defaults to unset, which means the last write wins."
 }
 },
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaSelectionLimits": {
-"description": "Limits for selection Field type.",
+"description": "Limits for selection field type.",
 "id": "GoogleAppsDriveLabelsV2betaSelectionLimits",
 "properties": {
 "listLimits": {
 "$ref": "GoogleAppsDriveLabelsV2betaListLimits",
-"description": "Limits for list-variant of a Field type."
+"description": "Limits for list-variant of a field type."
 },
 "maxChoices": {
-"description": "The max number of choices.",
+"description": "Maximum number of choices.",
 "format": "int32",
 "type": "integer"
 },
@@ -2875,7 +2875,7 @@
 "type": "integer"
 },
 "maxIdLength": {
-"description": "Maximum ID length for a selection options.",
+"description": "Maximum ID length for a selection option.",
 "format": "int32",
 "type": "integer"
 }
@@ -2883,16 +2883,16 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaTextLimits": {
-"description": "Limits for text Field type.",
+"description": "Limits for text field type.",
 "id": "GoogleAppsDriveLabelsV2betaTextLimits",
 "properties": {
 "maxLength": {
-"description": "Maximum length allowed for a text Field type.",
+"description": "Maximum length allowed for a text field type.",
 "format": "int32",
 "type": "integer"
 },
 "minLength": {
-"description": "Minimum length allowed for a text Field type.",
+"description": "Minimum length allowed for a text field type.",
 "format": "int32",
 "type": "integer"
 }
@@ -2900,11 +2900,11 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaUpdateLabelCopyModeRequest": {
-"description": "Request to update the `CopyMode` of the given Label. Changes to this policy are not revisioned, do not require publishing, and take effect immediately. \\",
+"description": "Request to update the `CopyMode` of the given label. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately. \\",
 "id": "GoogleAppsDriveLabelsV2betaUpdateLabelCopyModeRequest",
 "properties": {
 "copyMode": {
-"description": "Required. Indicates how the applied Label, and Field values should be copied when a Drive item is copied.",
+"description": "Required. Indicates how the applied label and field values should be copied when a Drive item is copied.",
 "enum": [
 "COPY_MODE_UNSPECIFIED",
 "DO_NOT_COPY",
@@ -2913,7 +2913,7 @@
 ],
 "enumDescriptions": [
 "Copy mode unspecified.",
-"The applied label and field values are not copied by default when the Drive item it's applied to is copied.",
+"The applied label and field values aren't copied by default when the Drive item it's applied to is copied.",
 "The applied label and field values are always copied when the Drive item it's applied to is copied. Only admins can use this mode.",
 "The applied label and field values are copied if the label is appliable by the user making the copy."
 ],
@@ -2924,7 +2924,7 @@
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "view": {
@@ -2943,19 +2943,19 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaUpdateLabelEnabledAppSettingsRequest": {
-"description": "Request to update the `EnabledAppSettings` of the given Label. This change is not revisioned, does not require publishing, and takes effect immediately. \\",
+"description": "Request to update the `EnabledAppSettings` of the given label. This change is not revisioned, doesn't require publishing, and takes effect immediately. \\",
 "id": "GoogleAppsDriveLabelsV2betaUpdateLabelEnabledAppSettingsRequest",
 "properties": {
 "enabledAppSettings": {
 "$ref": "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettings",
-"description": "Required. The new `EnabledAppSettings` value for the Label."
+"description": "Required. The new `EnabledAppSettings` value for the label."
 },
 "languageCode": {
 "description": "Optional. The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.",
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Optional. Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Optional. Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 },
 "view": {
@@ -2974,19 +2974,19 @@
 "type": "object"
 },
 "GoogleAppsDriveLabelsV2betaUpdateLabelPermissionRequest": {
-"description": "Updates a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.",
+"description": "Updates a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.",
 "id": "GoogleAppsDriveLabelsV2betaUpdateLabelPermissionRequest",
 "properties": {
 "labelPermission": {
 "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission",
-"description": "Required. The permission to create or update on the Label."
+"description": "Required. The permission to create or update on the label."
 },
 "parent": {
-"description": "Required. The parent Label resource name.",
+"description": "Required. The parent label resource name.",
 "type": "string"
 },
 "useAdminAccess": {
-"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.",
+"description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.",
 "type": "boolean"
 }
 },
@@ -3007,12 +3007,12 @@
 "type": "boolean"
 },
 "canCreateAdminLabels": {
-"description": "Output only. Whether the user is allowed to create new admin labels.",
+"description": "Output only. Whether the user is allowed to create admin labels.",
 "readOnly": true,
 "type": "boolean"
 },
 "canCreateSharedLabels": {
-"description": "Output only. Whether the user is allowed to create new shared labels.",
+"description": "Output only. Whether the user is allowed to create shared labels.",
 "readOnly": true,
 "type": "boolean"
 },
@@ -3029,7 +3029,7 @@
 "id": "GoogleAppsDriveLabelsV2betaUserInfo",
 "properties": {
 "person": {
-"description": "The identifier for this user that can be used with the People API to get more information. For example, people/12345678.",
+"description": "The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.",
 "type": "string"
 }
 },
@@ -3041,7 +3041,7 @@
 "properties": {
 "listLimits": {
 "$ref": "GoogleAppsDriveLabelsV2betaListLimits",
-"description": "Limits for list-variant of a Field type."
+"description": "Limits for list-variant of a field type."
 }
 },
 "type": "object"
@@ -3051,7 +3051,7 @@
 "id": "GoogleAppsDriveLabelsV2betaWriteControl",
 "properties": {
 "requiredRevisionId": {
-"description": "The revision_id of the label that the write request will be applied to. If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.",
+"description": "The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.",
 "type": "string"
 }
 },
diff --git a/googleapiclient/discovery_cache/documents/eventarc.v1.json b/googleapiclient/discovery_cache/documents/eventarc.v1.json
index f42db7aecab..2ccd866fe6a 100644
--- a/googleapiclient/discovery_cache/documents/eventarc.v1.json
+++ b/googleapiclient/discovery_cache/documents/eventarc.v1.json
@@ -2466,7 +2466,7 @@
 }
 }
 },
-"revision": "20250624",
+"revision": "20250801",
 "rootUrl": "https://eventarc.googleapis.com/",
 "schemas": {
 "AuditConfig": {
@@ -2555,7 +2555,7 @@
 "type": "string"
 },
 "cryptoKeyName": {
-"description": "Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.",
+"description": "Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.",
 "type": "string"
 },
 "labels": {
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1.json b/googleapiclient/discovery_cache/documents/gkehub.v1.json
index 7700dc64a8b..2ddba67a6de 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v1.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v1.json
@@ -2117,7 +2117,7 @@
 }
 }
 },
-"revision": "20250720",
+"revision": "20250731",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceFeatureSpec": {
@@ -6307,7 +6307,18 @@
 "MODERNIZATION_IN_PROGRESS",
 "MODERNIZATION_COMPLETED",
 "MODERNIZATION_ABORTED",
-"MODERNIZATION_WILL_BE_SCHEDULED"
+"MODERNIZATION_PREPARING",
+"MODERNIZATION_STALLED",
+"MODERNIZATION_PREPARED",
+"MODERNIZATION_MIGRATING_WORKLOADS",
+"MODERNIZATION_ROLLING_BACK_CLUSTER",
+"MODERNIZATION_WILL_BE_SCHEDULED",
+"MODERNIZATION_MANUAL",
+"MODERNIZATION_ELIGIBLE",
+"MODERNIZATION_MODERNIZING",
+"MODERNIZATION_MODERNIZED_SOAKING",
+"MODERNIZATION_FINALIZED",
+"MODERNIZATION_ROLLING_BACK_FLEET"
 ],
 "enumDescriptions": [
 "Default Unspecified code",
@@ -6351,7 +6362,18 @@
 "Modernization is in progress for a cluster.",
 "Modernization is completed for a cluster.",
 "Modernization is aborted for a cluster.",
-"Modernization will be scheduled for a fleet."
+"Preparing cluster so that its workloads can be migrated.",
+"Modernization is stalled for a cluster.",
+"Cluster has been prepared for its workloads to be migrated.",
+"Migrating the cluster's workloads to the new implementation.",
+"Rollback is in progress for modernization of a cluster.",
+"Modernization will be scheduled for a fleet.",
+"Fleet is opted out from automated modernization.",
+"Fleet is eligible for modernization.",
+"Modernization of one or more clusters in a fleet is in progress.",
+"Modernization of all the fleet's clusters is complete. Soaking before finalizing the modernization.",
+"Modernization is finalized for all clusters in a fleet. Rollback is no longer allowed.",
+"Rollback is in progress for modernization of all clusters in a fleet."
 ],
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json b/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
index 23bf3e8e8db..1bbbc0dd390 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
@@ -2261,7 +2261,7 @@
 }
 }
 },
-"revision": "20250720",
+"revision": "20250731",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceFeatureSpec": {
@@ -6891,7 +6891,18 @@
 "MODERNIZATION_IN_PROGRESS",
 "MODERNIZATION_COMPLETED",
 "MODERNIZATION_ABORTED",
-"MODERNIZATION_WILL_BE_SCHEDULED"
+"MODERNIZATION_PREPARING",
+"MODERNIZATION_STALLED",
+"MODERNIZATION_PREPARED",
+"MODERNIZATION_MIGRATING_WORKLOADS",
+"MODERNIZATION_ROLLING_BACK_CLUSTER",
+"MODERNIZATION_WILL_BE_SCHEDULED",
+"MODERNIZATION_MANUAL",
+"MODERNIZATION_ELIGIBLE",
+"MODERNIZATION_MODERNIZING",
+"MODERNIZATION_MODERNIZED_SOAKING",
+"MODERNIZATION_FINALIZED",
+"MODERNIZATION_ROLLING_BACK_FLEET"
 ],
 "enumDescriptions": [
 "Default Unspecified code",
@@ -6935,7 +6946,18 @@
 "Modernization is in progress for a cluster.",
 "Modernization is completed for a cluster.",
 "Modernization is aborted for a cluster.",
-"Modernization will be scheduled for a fleet."
+"Preparing cluster so that its workloads can be migrated.",
+"Modernization is stalled for a cluster.",
+"Cluster has been prepared for its workloads to be migrated.",
+"Migrating the cluster's workloads to the new implementation.",
+"Rollback is in progress for modernization of a cluster.",
+"Modernization will be scheduled for a fleet.",
+"Fleet is opted out from automated modernization.",
+"Fleet is eligible for modernization.",
+"Modernization of one or more clusters in a fleet is in progress.",
+"Modernization of all the fleet's clusters is complete. Soaking before finalizing the modernization.",
+"Modernization is finalized for all clusters in a fleet. Rollback is no longer allowed.",
+"Rollback is in progress for modernization of all clusters in a fleet."
 ],
 "type": "string"
 },
@@ -7111,7 +7133,18 @@
 "MODERNIZATION_IN_PROGRESS",
 "MODERNIZATION_COMPLETED",
 "MODERNIZATION_ABORTED",
-"MODERNIZATION_WILL_BE_SCHEDULED"
+"MODERNIZATION_PREPARING",
+"MODERNIZATION_STALLED",
+"MODERNIZATION_PREPARED",
+"MODERNIZATION_MIGRATING_WORKLOADS",
+"MODERNIZATION_ROLLING_BACK_CLUSTER",
+"MODERNIZATION_WILL_BE_SCHEDULED",
+"MODERNIZATION_MANUAL",
+"MODERNIZATION_ELIGIBLE",
+"MODERNIZATION_MODERNIZING",
+"MODERNIZATION_MODERNIZED_SOAKING",
+"MODERNIZATION_FINALIZED",
+"MODERNIZATION_ROLLING_BACK_FLEET"
 ],
 "enumDescriptions": [
 "Default Unspecified code",
@@ -7155,7 +7188,18 @@
 "Modernization is in progress for a cluster.",
 "Modernization is completed for a cluster.",
 "Modernization is aborted for a cluster.",
-"Modernization will be scheduled for a fleet."
+"Preparing cluster so that its workloads can be migrated.",
+"Modernization is stalled for a cluster.",
+"Cluster has been prepared for its workloads to be migrated.",
+"Migrating the cluster's workloads to the new implementation.",
+"Rollback is in progress for modernization of a cluster.",
+"Modernization will be scheduled for a fleet.",
+"Fleet is opted out from automated modernization.",
+"Fleet is eligible for modernization.",
+"Modernization of one or more clusters in a fleet is in progress.",
+"Modernization of all the fleet's clusters is complete. Soaking before finalizing the modernization.",
+"Modernization is finalized for all clusters in a fleet. Rollback is no longer allowed.",
+"Rollback is in progress for modernization of all clusters in a fleet."
 ],
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1beta.json b/googleapiclient/discovery_cache/documents/gkehub.v1beta.json
index 091731a7fb4..40569ecc7d6 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v1beta.json
@@ -2117,7 +2117,7 @@
 }
 }
 },
-"revision": "20250720",
+"revision": "20250731",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceFeatureSpec": {
@@ -6433,7 +6433,18 @@
 "MODERNIZATION_IN_PROGRESS",
 "MODERNIZATION_COMPLETED",
 "MODERNIZATION_ABORTED",
-"MODERNIZATION_WILL_BE_SCHEDULED"
+"MODERNIZATION_PREPARING",
+"MODERNIZATION_STALLED",
+"MODERNIZATION_PREPARED",
+"MODERNIZATION_MIGRATING_WORKLOADS",
+"MODERNIZATION_ROLLING_BACK_CLUSTER",
+"MODERNIZATION_WILL_BE_SCHEDULED",
+"MODERNIZATION_MANUAL",
+"MODERNIZATION_ELIGIBLE",
+"MODERNIZATION_MODERNIZING",
+"MODERNIZATION_MODERNIZED_SOAKING",
+"MODERNIZATION_FINALIZED",
+"MODERNIZATION_ROLLING_BACK_FLEET"
 ],
 "enumDescriptions": [
 "Default Unspecified code",
@@ -6477,7 +6488,18 @@
 "Modernization is in progress for a cluster.",
 "Modernization is completed for a cluster.",
 "Modernization is aborted for a cluster.",
-"Modernization will be scheduled for a fleet."
+"Preparing cluster so that its workloads can be migrated.",
+"Modernization is stalled for a cluster.",
+"Cluster has been prepared for its workloads to be migrated.",
+"Migrating the cluster's workloads to the new implementation.",
+"Rollback is in progress for modernization of a cluster.",
+"Modernization will be scheduled for a fleet.",
+"Fleet is opted out from automated modernization.",
+"Fleet is eligible for modernization.",
+"Modernization of one or more clusters in a fleet is in progress.",
+"Modernization of all the fleet's clusters is complete. Soaking before finalizing the modernization.",
+"Modernization is finalized for all clusters in a fleet. Rollback is no longer allowed.",
+"Rollback is in progress for modernization of all clusters in a fleet."
 ],
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v2.json b/googleapiclient/discovery_cache/documents/gkehub.v2.json
index 4300d9996f9..e90afcea278 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v2.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v2.json
@@ -477,7 +477,7 @@
 }
 }
 },
-"revision": "20250720",
+"revision": "20250731",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceState": {
@@ -3065,7 +3065,18 @@
 "MODERNIZATION_IN_PROGRESS",
 "MODERNIZATION_COMPLETED",
 "MODERNIZATION_ABORTED",
-"MODERNIZATION_WILL_BE_SCHEDULED"
+"MODERNIZATION_PREPARING",
+"MODERNIZATION_STALLED",
+"MODERNIZATION_PREPARED",
+"MODERNIZATION_MIGRATING_WORKLOADS",
+"MODERNIZATION_ROLLING_BACK_CLUSTER",
+"MODERNIZATION_WILL_BE_SCHEDULED",
+"MODERNIZATION_MANUAL",
+"MODERNIZATION_ELIGIBLE",
+"MODERNIZATION_MODERNIZING",
+"MODERNIZATION_MODERNIZED_SOAKING",
+"MODERNIZATION_FINALIZED",
+"MODERNIZATION_ROLLING_BACK_FLEET"
 ],
 "enumDescriptions": [
 "Default Unspecified code",
@@ -3109,7 +3120,18 @@
 "Modernization is in progress for a cluster.",
 "Modernization is completed for a cluster.",
 "Modernization is aborted for a cluster.",
-"Modernization will be scheduled for a fleet."
+"Preparing cluster so that its workloads can be migrated.",
+"Modernization is stalled for a cluster.",
+"Cluster has been prepared for its workloads to be migrated.",
+"Migrating the cluster's workloads to the new implementation.",
+"Rollback is in progress for modernization of a cluster.",
+"Modernization will be scheduled for a fleet.",
+"Fleet is opted out from automated modernization.",
+"Fleet is eligible for modernization.",
+"Modernization of one or more clusters in a fleet is in progress.",
+"Modernization of all the fleet's clusters is complete. Soaking before finalizing the modernization.",
+"Modernization is finalized for all clusters in a fleet. Rollback is no longer allowed.",
+"Rollback is in progress for modernization of all clusters in a fleet."
 ],
 "type": "string"
 },
@@ -3296,7 +3318,7 @@
 "MANAGEMENT_NOT_INSTALLED"
 ],
 "enumDescriptions": [
-"Unspecified",
+"Unspecified.",
 "Google should manage my Service Mesh for the cluster.",
 "User will manually configure their service mesh components.",
 "Google should remove any managed Service Mesh components from this cluster and deprovision any resources."
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json b/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json
index 9b525e6213e..3b5c68da4f2 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json
@@ -477,7 +477,7 @@
 }
 }
 },
-"revision": "20250720",
+"revision": "20250731",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceState": {
@@ -3065,7 +3065,18 @@
 "MODERNIZATION_IN_PROGRESS",
 "MODERNIZATION_COMPLETED",
 "MODERNIZATION_ABORTED",
-"MODERNIZATION_WILL_BE_SCHEDULED"
+"MODERNIZATION_PREPARING",
+"MODERNIZATION_STALLED",
+"MODERNIZATION_PREPARED",
+"MODERNIZATION_MIGRATING_WORKLOADS",
+"MODERNIZATION_ROLLING_BACK_CLUSTER",
+"MODERNIZATION_WILL_BE_SCHEDULED",
+"MODERNIZATION_MANUAL",
+"MODERNIZATION_ELIGIBLE",
+"MODERNIZATION_MODERNIZING",
+"MODERNIZATION_MODERNIZED_SOAKING",
+"MODERNIZATION_FINALIZED",
+"MODERNIZATION_ROLLING_BACK_FLEET"
 ],
 "enumDescriptions": [
 "Default Unspecified code",
@@ -3109,7 +3120,18 @@
 "Modernization is in progress for a cluster.",
 "Modernization is completed for a cluster.",
 "Modernization is aborted for a cluster.",
-"Modernization will be scheduled for a fleet."
+"Preparing cluster so that its workloads can be migrated.",
+"Modernization is stalled for a cluster.",
+"Cluster has been prepared for its workloads to be migrated.",
+"Migrating the cluster's workloads to the new implementation.",
+"Rollback is in progress for modernization of a cluster.",
+"Modernization will be scheduled for a fleet.",
+"Fleet is opted out from automated modernization.",
+"Fleet is eligible for modernization.",
+"Modernization of one or more clusters in a fleet is in progress.",
+"Modernization of all the fleet's clusters is complete. Soaking before finalizing the modernization.",
+"Modernization is finalized for all clusters in a fleet. Rollback is no longer allowed.",
+"Rollback is in progress for modernization of all clusters in a fleet."
 ],
 "type": "string"
 },
@@ -3296,7 +3318,7 @@
 "MANAGEMENT_NOT_INSTALLED"
 ],
 "enumDescriptions": [
-"Unspecified",
+"Unspecified.",
 "Google should manage my Service Mesh for the cluster.",
 "User will manually configure their service mesh components.",
 "Google should remove any managed Service Mesh components from this cluster and deprovision any resources."
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v2beta.json b/googleapiclient/discovery_cache/documents/gkehub.v2beta.json
index c872d178183..7cf0a0e9cc5 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v2beta.json
@@ -477,7 +477,7 @@
 }
 }
 },
-"revision": "20250720",
+"revision": "20250731",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceState": {
@@ -3065,7 +3065,18 @@
 "MODERNIZATION_IN_PROGRESS",
 "MODERNIZATION_COMPLETED",
 "MODERNIZATION_ABORTED",
-"MODERNIZATION_WILL_BE_SCHEDULED"
+"MODERNIZATION_PREPARING",
+"MODERNIZATION_STALLED",
+"MODERNIZATION_PREPARED",
+"MODERNIZATION_MIGRATING_WORKLOADS",
+"MODERNIZATION_ROLLING_BACK_CLUSTER",
+"MODERNIZATION_WILL_BE_SCHEDULED",
+"MODERNIZATION_MANUAL",
+"MODERNIZATION_ELIGIBLE",
+"MODERNIZATION_MODERNIZING",
+"MODERNIZATION_MODERNIZED_SOAKING",
+"MODERNIZATION_FINALIZED",
+"MODERNIZATION_ROLLING_BACK_FLEET"
 ],
 "enumDescriptions": [
 "Default Unspecified code",
@@ -3109,7 +3120,18 @@
 "Modernization is in progress for a cluster.",
 "Modernization is completed for a cluster.",
 "Modernization is aborted for a cluster.",
-"Modernization will be scheduled for a fleet."
+"Preparing cluster so that its workloads can be migrated.",
+"Modernization is stalled for a cluster.",
+"Cluster has been prepared for its workloads to be migrated.",
+"Migrating the cluster's workloads to the new implementation.",
+"Rollback is in progress for modernization of a cluster.",
+"Modernization will be scheduled for a fleet.",
+"Fleet is opted out from automated modernization.",
+"Fleet is eligible for modernization.",
+"Modernization of one or more clusters in a fleet is in progress.",
+"Modernization of all the fleet's clusters is complete. Soaking before finalizing the modernization.",
+"Modernization is finalized for all clusters in a fleet. Rollback is no longer allowed.",
+"Rollback is in progress for modernization of all clusters in a fleet."
 ],
 "type": "string"
 },
@@ -3296,7 +3318,7 @@
 "MANAGEMENT_NOT_INSTALLED"
 ],
 "enumDescriptions": [
-"Unspecified",
+"Unspecified.",
 "Google should manage my Service Mesh for the cluster.",
 "User will manually configure their service mesh components.",
 "Google should remove any managed Service Mesh components from this cluster and deprovision any resources."
diff --git a/googleapiclient/discovery_cache/documents/monitoring.v3.json b/googleapiclient/discovery_cache/documents/monitoring.v3.json
index fe94a95e39f..c7e992323b0 100644
--- a/googleapiclient/discovery_cache/documents/monitoring.v3.json
+++ b/googleapiclient/discovery_cache/documents/monitoring.v3.json
@@ -2720,7 +2720,7 @@
 }
 }
 },
-"revision": "20250723",
+"revision": "20250731",
 "rootUrl": "https://monitoring.googleapis.com/",
 "schemas": {
 "Aggregation": {
@@ -4542,7 +4542,7 @@
 "type": "array"
 },
 "duration": {
-"description": "The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned. The Duration.nanos field is ignored.",
+"description": "Required. The amount of time that a time series must fail to report new data to be considered failing. The minimum value of this field is 120 seconds. Larger values that are a multiple of a minute--for example, 240 or 300 seconds--are supported. If an invalid value is given, an error will be returned.",
 "format": "google-duration",
 "type": "string"
 },
@@ -4785,7 +4785,7 @@
 "type": "string"
 },
 "duration": {
-"description": "The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.",
+"description": "Required. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.",
 "format": "google-duration",
 "type": "string"
 },
@@ -4936,7 +4936,7 @@
 "id": "MonitoringQueryLanguageCondition",
 "properties": {
 "duration": {
-"description": "The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly.",
+"description": "Optional. The amount of time that a time series must violate the threshold to be considered failing. Currently, only values that are a multiple of a minute--e.g., 0, 60, 120, or 300 seconds--are supported. If an invalid value is given, an error will be returned. When choosing a duration, it is useful to keep in mind the frequency of the underlying time series data (which may also be affected by any alignments specified in the aggregations field); a good duration is long enough so that a single outlier does not generate spurious alerts, but short enough that unhealthy states are detected and alerted on quickly. The default value is zero.",
 "format": "google-duration",
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/networksecurity.v1.json b/googleapiclient/discovery_cache/documents/networksecurity.v1.json
index dc50f2794a7..379e68f1a84 100644
--- a/googleapiclient/discovery_cache/documents/networksecurity.v1.json
+++ b/googleapiclient/discovery_cache/documents/networksecurity.v1.json
@@ -5070,7 +5070,7 @@
 }
 }
 },
-"revision": "20250714",
+"revision": "20250804",
 "rootUrl": "https://networksecurity.googleapis.com/",
 "schemas": {
 "AddAddressGroupItemsRequest": {
@@ -5387,21 +5387,21 @@
 "id": "AuthzPolicyAuthzRuleFromRequestSource",
 "properties": {
 "ipBlocks": {
-"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.",
+"description": "Optional. A list of IP addresses or IP address ranges to match against the source IP address of the request. Limited to 10 ip_blocks per Authorization Policy",
 "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.",
+"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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.",
 "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.",
+"description": "Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.",
 "items": {
 "$ref": "AuthzPolicyAuthzRuleRequestResource"
 },
@@ -5459,9 +5459,9 @@
 ],
 "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."
+"The principal rule is matched against a list of URI SANs in the validated client's 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's 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's 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"
 }
@@ -5488,7 +5488,7 @@
 "id": "AuthzPolicyAuthzRuleRequestResourceTagValueIdSet",
 "properties": {
 "ids": {
-"description": "Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.",
+"description": "Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.",
 "items": {
 "format": "int64",
 "type": "string"
@@ -5555,21 +5555,21 @@
 "description": "Optional. A list of headers to match against in http header."
 },
 "hosts": {
-"description": "Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.",
+"description": "Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.",
 "items": {
 "$ref": "AuthzPolicyAuthzRuleStringMatch"
 },
 "type": "array"
 },
 "methods": {
-"description": "Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.",
+"description": "Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "paths": {
-"description": "Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.",
+"description": "Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.",
 "items": {
 "$ref": "AuthzPolicyAuthzRuleStringMatch"
 },
@@ -5583,7 +5583,7 @@
 "id": "AuthzPolicyAuthzRuleToRequestOperationHeaderSet",
 "properties": {
 "headers": {
-"description": "Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.",
+"description": "Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.",
 "items": {
 "$ref": "AuthzPolicyAuthzRuleHeaderMatch"
 },
diff --git a/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json b/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json
index 3fc40c2e4b3..ecaf34ce0da 100644
--- a/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json
@@ -5513,7 +5513,7 @@
 }
 }
 },
-"revision": "20250721",
+"revision": "20250804",
 "rootUrl": "https://networksecurity.googleapis.com/",
 "schemas": {
 "AddAddressGroupItemsRequest": {
@@ -5830,21 +5830,21 @@
 "id": "AuthzPolicyAuthzRuleFromRequestSource",
 "properties": {
 "ipBlocks": {
-"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.",
+"description": "Optional. A list of IP addresses or IP address ranges to match against the source IP address of the request. Limited to 10 ip_blocks per Authorization Policy",
 "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.",
+"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 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.",
 "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.",
+"description": "Optional. A list of resources to match against the resource of the source VM of a request. Limited to 10 resources per Authorization Policy.",
 "items": {
 "$ref": "AuthzPolicyAuthzRuleRequestResource"
 },
@@ -5902,9 +5902,9 @@
 ],
 "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."
+"The principal rule is matched against a list of URI SANs in the validated client's 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's 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's 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"
 }
@@ -5931,7 +5931,7 @@
 "id": "AuthzPolicyAuthzRuleRequestResourceTagValueIdSet",
 "properties": {
 "ids": {
-"description": "Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 matches.",
+"description": "Required. A list of resource tag value permanent IDs to match against the resource manager tags value associated with the source VM of a request. The match follows AND semantics which means all the ids must match. Limited to 5 ids in the Tag value id set.",
 "items": {
 "format": "int64",
 "type": "string"
@@ -5998,21 +5998,21 @@
 "description": "Optional. A list of headers to match against in http header."
 },
 "hosts": {
-"description": "Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.",
+"description": "Optional. A list of HTTP Hosts to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 hosts per Authorization Policy.",
 "items": {
 "$ref": "AuthzPolicyAuthzRuleStringMatch"
 },
 "type": "array"
 },
 "methods": {
-"description": "Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive.",
+"description": "Optional. A list of HTTP methods to match against. Each entry must be a valid HTTP method name (GET, PUT, POST, HEAD, PATCH, DELETE, OPTIONS). It only allows exact match and is always case sensitive. Limited to 10 methods per Authorization Policy.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "paths": {
-"description": "Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.",
+"description": "Optional. A list of paths to match against. The match can be one of exact, prefix, suffix, or contains (substring match). Matches are always case sensitive unless the ignoreCase is set. Limited to 10 paths per Authorization Policy. Note that this path match includes the query parameters. For gRPC services, this should be a fully-qualified name of the form /package.service/method.",
 "items": {
 "$ref": "AuthzPolicyAuthzRuleStringMatch"
 },
@@ -6026,7 +6026,7 @@
 "id": "AuthzPolicyAuthzRuleToRequestOperationHeaderSet",
 "properties": {
 "headers": {
-"description": "Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 5 matches.",
+"description": "Required. A list of headers to match against in http header. The match can be one of exact, prefix, suffix, or contains (substring match). The match follows AND semantics which means all the headers must match. Matches are always case sensitive unless the ignoreCase is set. Limited to 10 headers per Authorization Policy.",
 "items": {
 "$ref": "AuthzPolicyAuthzRuleHeaderMatch"
 },
@@ -6298,7 +6298,7 @@
 "type": "object"
 },
 "DnsThreatDetector": {
-"description": "Message describing DnsThreatDetector object",
+"description": "Message describing DnsThreatDetector object.",
 "id": "DnsThreatDetector",
 "properties": {
 "createTime": {
@@ -7456,7 +7456,7 @@
 "type": "object"
 },
 "ListDnsThreatDetectorsResponse": {
-"description": "Message for response to listing DnsThreatDetectors",
+"description": "Message for response to listing DnsThreatDetectors.",
 "id": "ListDnsThreatDetectorsResponse",
 "properties": {
 "dnsThreatDetectors": {
diff --git a/googleapiclient/discovery_cache/documents/solar.v1.json b/googleapiclient/discovery_cache/documents/solar.v1.json
index 2b0b3c3558d..b15fdfd13ee 100644
--- a/googleapiclient/discovery_cache/documents/solar.v1.json
+++ b/googleapiclient/discovery_cache/documents/solar.v1.json
@@ -154,7 +154,7 @@
 "Solar data is derived from aerial imagery captured at low-altitude and processed at 0.1 m/pixel.",
 "Solar data is derived from enhanced aerial imagery captured at high-altitude and processed at 0.25 m/pixel.",
 "Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.",
-"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel. **Note:** This enum is only available if `experiments=EXPANDED_COVERAGE` is set in the request. For more information, see [Expanded Coverage](https://developers.google.com/maps/documentation/solar/expanded-coverage)."
+"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel."
 ],
 "location": "query",
 "type": "string"
@@ -236,7 +236,7 @@
 "Solar data is derived from aerial imagery captured at low-altitude and processed at 0.1 m/pixel.",
 "Solar data is derived from enhanced aerial imagery captured at high-altitude and processed at 0.25 m/pixel.",
 "Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.",
-"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel. **Note:** This enum is only available if `experiments=EXPANDED_COVERAGE` is set in the request. For more information, see [Expanded Coverage](https://developers.google.com/maps/documentation/solar/expanded-coverage)."
+"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel."
 ],
 "location": "query",
 "type": "string"
@@ -299,7 +299,7 @@
 }
 }
 },
-"revision": "20250427",
+"revision": "20250804",
 "rootUrl": "https://solar.googleapis.com/",
 "schemas": {
 "BuildingInsights": {
@@ -340,7 +340,7 @@
 "Solar data is derived from aerial imagery captured at low-altitude and processed at 0.1 m/pixel.",
 "Solar data is derived from enhanced aerial imagery captured at high-altitude and processed at 0.25 m/pixel.",
 "Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.",
-"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel. **Note:** This enum is only available if `experiments=EXPANDED_COVERAGE` is set in the request. For more information, see [Expanded Coverage](https://developers.google.com/maps/documentation/solar/expanded-coverage)."
+"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel."
 ],
 "type": "string"
 },
@@ -436,7 +436,7 @@
 "Solar data is derived from aerial imagery captured at low-altitude and processed at 0.1 m/pixel.",
 "Solar data is derived from enhanced aerial imagery captured at high-altitude and processed at 0.25 m/pixel.",
 "Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.",
-"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel. **Note:** This enum is only available if `experiments=EXPANDED_COVERAGE` is set in the request. For more information, see [Expanded Coverage](https://developers.google.com/maps/documentation/solar/expanded-coverage)."
+"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel."
 ],
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/storagetransfer.v1.json b/googleapiclient/discovery_cache/documents/storagetransfer.v1.json
index 4f0f3301048..f422ba7c25d 100644
--- a/googleapiclient/discovery_cache/documents/storagetransfer.v1.json
+++ b/googleapiclient/discovery_cache/documents/storagetransfer.v1.json
@@ -632,7 +632,7 @@
 }
 }
 },
-"revision": "20250523",
+"revision": "20250801",
 "rootUrl": "https://storagetransfer.googleapis.com/",
 "schemas": {
 "AgentPool": {
@@ -841,14 +841,15 @@
 "id": "ErrorLogEntry",
 "properties": {
 "errorDetails": {
-"description": "A list of messages that carry the error details.",
+"description": "Optional. A list of messages that carry the error details.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "url": {
-"description": "Required. A URL that refers to the target (a data source, a data sink, or an object) with which the error is associated.",
+"description": "Output only. A URL that refers to the target (a data source, a data sink, or an object) with which the error is associated.",
+"readOnly": true,
 "type": "string"
 }
 },
@@ -1902,23 +1903,23 @@
 "properties": {
 "awsS3CompatibleDataSource": {
 "$ref": "AwsS3CompatibleData",
-"description": "An AWS S3 compatible data source."
+"description": "Optional. An AWS S3 compatible data source."
 },
 "awsS3DataSource": {
 "$ref": "AwsS3Data",
-"description": "An AWS S3 data source."
+"description": "Optional. An AWS S3 data source."
 },
 "azureBlobStorageDataSource": {
 "$ref": "AzureBlobStorageData",
-"description": "An Azure Blob Storage data source."
+"description": "Optional. An Azure Blob Storage data source."
 },
 "gcsDataSink": {
 "$ref": "GcsData",
-"description": "A Cloud Storage data sink."
+"description": "Optional. A Cloud Storage data sink."
 },
 "gcsDataSource": {
 "$ref": "GcsData",
-"description": "A Cloud Storage data source."
+"description": "Optional. A Cloud Storage data source."
 },
 "gcsIntermediateDataLocation": {
 "$ref": "GcsData",
@@ -1926,11 +1927,11 @@
 },
 "hdfsDataSource": {
 "$ref": "HdfsData",
-"description": "An HDFS cluster data source."
+"description": "Optional. An HDFS cluster data source."
 },
 "httpDataSource": {
 "$ref": "HttpData",
-"description": "An HTTP URL data source."
+"description": "Optional. An HTTP URL data source."
 },
 "objectConditions": {
 "$ref": "ObjectConditions",
@@ -1938,11 +1939,11 @@
 },
 "posixDataSink": {
 "$ref": "PosixFilesystem",
-"description": "A POSIX Filesystem data sink."
+"description": "Optional. A POSIX Filesystem data sink."
 },
 "posixDataSource": {
 "$ref": "PosixFilesystem",
-"description": "A POSIX Filesystem data source."
+"description": "Optional. A POSIX Filesystem data source."
 },
 "sinkAgentPoolName": {
 "description": "Specifies the agent pool name associated with the posix data sink. When unspecified, the default name is used.",
diff --git a/googleapiclient/discovery_cache/documents/vision.v1.json b/googleapiclient/discovery_cache/documents/vision.v1.json
index 5f29da0f7aa..15046d572bf 100644
--- a/googleapiclient/discovery_cache/documents/vision.v1.json
+++ b/googleapiclient/discovery_cache/documents/vision.v1.json
@@ -1282,7 +1282,7 @@
 }
 }
 },
-"revision": "20241115",
+"revision": "20250804",
 "rootUrl": "https://vision.googleapis.com/",
 "schemas": {
 "AddProductToProductSetRequest": {
@@ -2174,7 +2174,7 @@
 "type": "integer"
 },
 "model": {
-"description": "Model to use for the feature. Supported values: \"builtin/stable\" (the default if unset) and \"builtin/latest\". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support \"builtin/weekly\" for the bleeding edge release updated weekly.",
+"description": "Model to use for the feature. Supported values: \"builtin/stable\" (the default if unset) and \"builtin/latest\". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support \"builtin/rc\" for the latest release candidate.",
 "type": "string"
 },
 "type": {
diff --git a/googleapiclient/discovery_cache/documents/vision.v1p1beta1.json b/googleapiclient/discovery_cache/documents/vision.v1p1beta1.json
index 8af3ea5ba83..e5fc252a46b 100644
--- a/googleapiclient/discovery_cache/documents/vision.v1p1beta1.json
+++ b/googleapiclient/discovery_cache/documents/vision.v1p1beta1.json
@@ -449,7 +449,7 @@
 }
 }
 },
-"revision": "20240823",
+"revision": "20250804",
 "rootUrl": "https://vision.googleapis.com/",
 "schemas": {
 "AnnotateFileResponse": {
@@ -1958,7 +1958,7 @@
 "type": "integer"
 },
 "model": {
-"description": "Model to use for the feature. Supported values: \"builtin/stable\" (the default if unset) and \"builtin/latest\". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support \"builtin/weekly\" for the bleeding edge release updated weekly.",
+"description": "Model to use for the feature. Supported values: \"builtin/stable\" (the default if unset) and \"builtin/latest\". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support \"builtin/rc\" for the latest release candidate.",
 "type": "string"
 },
 "type": {
diff --git a/googleapiclient/discovery_cache/documents/vision.v1p2beta1.json b/googleapiclient/discovery_cache/documents/vision.v1p2beta1.json
index f1107338425..1f5c0b50f20 100644
--- a/googleapiclient/discovery_cache/documents/vision.v1p2beta1.json
+++ b/googleapiclient/discovery_cache/documents/vision.v1p2beta1.json
@@ -449,7 +449,7 @@
 }
 }
 },
-"revision": "20240823",
+"revision": "20250804",
 "rootUrl": "https://vision.googleapis.com/",
 "schemas": {
 "AnnotateFileResponse": {
@@ -3372,7 +3372,7 @@
 "type": "integer"
 },
 "model": {
-"description": "Model to use for the feature. Supported values: \"builtin/stable\" (the default if unset) and \"builtin/latest\". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support \"builtin/weekly\" for the bleeding edge release updated weekly.",
+"description": "Model to use for the feature. Supported values: \"builtin/stable\" (the default if unset) and \"builtin/latest\". `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` also support \"builtin/rc\" for the latest release candidate.",
 "type": "string"
 },
 "type": {